f7cloud_mobile/docs/app-map/calendar.md

# Карта: Календарь

Приложение «Календарь» (`/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` («первый понедельник») — вскроется на развёртке повторений.