docs(app-map): канон карт приложений forbion — формат + разбивка по ролям (read-only)

docs/app-map/README.md

@@ -0,0 +1,59 @@
+# Карта приложений (forbion.f7cloud.ru)
+
+Рабочая карта UI каждого приложения на боевом forbion — **источник, по которому фич-роли
+сверяют и строят нативный мобильный клиент**. Составляется наблюдением живого сервера
+(аккаунт `cloude`, вход через мобильную веб-версию forbion в узком вьюпорте), **строго
+read-only** — ничего не создавать/не менять/не удалять, почту не отправлять (см. mail/073).
+
+## Где что лежит
+Одна карта на приложение: `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-классов.
+- Каждую кнопку/иконку — отдельной строкой с назначением. Если назначение неочевидно —
+  пометь `(?)` и опиши гипотезу.
+- Модалки/шиты/выпадающие меню — тоже экраны, раскрывай их.
+- Отмечай, где мобильная веб-версия отличается от того, что уже есть в нативном клиенте
+  (`расхождение:` …) — это сразу твой бэклог на добивку.
+- Пустые состояния и состояния ошибки — фиксируй (это отдельные экраны в дизайне).
+
+Готовую карту используем как чек-лист: сверка вёрстки и функционала нативного экрана идёт
+по этому дереву.