# Карта приложений (forbion.f7cloud.ru)

Рабочая карта UI каждого приложения на боевом forbion — **источник, по которому фич-роли
сверяют и строят нативный мобильный клиент**. Составляется наблюдением живого сервера
(аккаунт `cloude`), **строго read-only** — ничего не создавать/не менять/не удалять, почту
не отправлять (см. mail/073).

> ‼️ **ТОЛЬКО МОБИЛЬНАЯ ВЕРСИЯ САЙТА.** Карта строится по мобильной вёрстке forbion (узкий
> вьюпорт ~390–420px: браузер в device-режиме, реальный телефон или эмулятор), НЕ по
> десктопной — они принципиально разные, наш клиент повторяет мобильную. Признак мобильной
> версии: снизу плавающая панель + шторка приложений по «трём полоскам» (как в `_mobile-*.css`),
> а не десктопный сайдбар. Десктопный layout в карте недопустим.

## Где что лежит
Одна карта на приложение: `docs/app-map/<module>.md`. Владелец карты = фич-роль модуля.
Коммитит в свой файл автором `b-mob-<x>`, обычным ритуалом (`git pull --rebase` → правка).

| Файл | Роль | Приложение |
|---|---|---|
| `shell.md` | b-dev-mobile | Оболочка: нижняя панель, шторка приложений, бургер |
| `files.md` | b-mob-files | Файлы |
| `mail.md` | b-mob-mail | Почта (вход `cloude@forbion.ru`) |
| `talk.md` | b-mob-conf | Конференции |
| `tasks.md` | b-mob-tasks | Задачи |
| `notes.md` | b-mob-notes | Заметки |
| `notifications.md` | b-mob-notify | Уведомления (лента) |
| `deck.md` | b-mob-deck | Карточки |
| `calendar.md` | b-mob-calendar | Календарь |
| `contacts.md` | b-mob-contacts | Контакты |

## Формат (единый для всех)

Карта — это **дерево переходов**: экран → его кнопки/пункты → куда каждая ведёт → экран с
кнопками, и так вглубь. Для каждого экрана:

```markdown
# Карта: <Приложение>

## Вход
Как попадаем: нижняя панель / шторка / пункт меню — что именно нажать.

## Экран: <Название экрана>
**Шапка:** <кнопка → действие/экран>, <кнопка → …>
**Тело:** что показывается (список/сетка/форма/пусто-состояние).
**Действия:**
- «<Кнопка/пункт>» → <что делает: открывает экран X / диалог Y / выполняет действие Z>
  - (если ведёт в подэкран — раскрыть его тем же блоком: Шапка/Тело/Действия)
- «<⋯ / long-press / контекстное меню>» → пункты: «A» → …, «B» → …
- «<+ / FAB / создать>» → форма «<Название>»: поля <перечислить>, кнопки <Сохранить/Отмена>

## Экран: <Следующий>
…
```

Правила:
- Пиши ЧТО видит пользователь и КУДА ведёт — без реализации/CSS-классов.
- Каждую кнопку/иконку — отдельной строкой с назначением. Если назначение неочевидно —
  пометь `(?)` и опиши гипотезу.
- Модалки/шиты/выпадающие меню — тоже экраны, раскрывай их.
- Отмечай, где мобильная веб-версия отличается от того, что уже есть в нативном клиенте
  (`расхождение:` …) — это сразу твой бэклог на добивку.
- Пустые состояния и состояния ошибки — фиксируй (это отдельные экраны в дизайне).

Готовую карту используем как чек-лист: сверка вёрстки и функционала нативного экрана идёт
по этому дереву.
