From ece46edecca9a6c1ccb63440ef44eb63f7439b7d Mon Sep 17 00:00:00 2001 From: b-dev-mobile Date: Sun, 12 Jul 2026 19:11:40 +0000 Subject: [PATCH] =?UTF-8?q?docs(app-map):=20=D0=BA=D0=B0=D0=BD=D0=BE=D0=BD?= =?UTF-8?q?=20=D0=BA=D0=B0=D1=80=D1=82=20=D0=BF=D1=80=D0=B8=D0=BB=D0=BE?= =?UTF-8?q?=D0=B6=D0=B5=D0=BD=D0=B8=D0=B9=20forbion=20=E2=80=94=20=D1=84?= =?UTF-8?q?=D0=BE=D1=80=D0=BC=D0=B0=D1=82=20+=20=D1=80=D0=B0=D0=B7=D0=B1?= =?UTF-8?q?=D0=B8=D0=B2=D0=BA=D0=B0=20=D0=BF=D0=BE=20=D1=80=D0=BE=D0=BB?= =?UTF-8?q?=D1=8F=D0=BC=20(read-only)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/app-map/README.md | 59 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 59 insertions(+) create mode 100644 docs/app-map/README.md diff --git a/docs/app-map/README.md b/docs/app-map/README.md new file mode 100644 index 0000000..51dc91b --- /dev/null +++ b/docs/app-map/README.md @@ -0,0 +1,59 @@ +# Карта приложений (forbion.f7cloud.ru) + +Рабочая карта UI каждого приложения на боевом forbion — **источник, по которому фич-роли +сверяют и строят нативный мобильный клиент**. Составляется наблюдением живого сервера +(аккаунт `cloude`, вход через мобильную веб-версию forbion в узком вьюпорте), **строго +read-only** — ничего не создавать/не менять/не удалять, почту не отправлять (см. mail/073). + +## Где что лежит +Одна карта на приложение: `docs/app-map/.md`. Владелец карты = фич-роль модуля. +Коммитит в свой файл автором `b-mob-`, обычным ритуалом (`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-классов. +- Каждую кнопку/иконку — отдельной строкой с назначением. Если назначение неочевидно — + пометь `(?)` и опиши гипотезу. +- Модалки/шиты/выпадающие меню — тоже экраны, раскрывай их. +- Отмечай, где мобильная веб-версия отличается от того, что уже есть в нативном клиенте + (`расхождение:` …) — это сразу твой бэклог на добивку. +- Пустые состояния и состояния ошибки — фиксируй (это отдельные экраны в дизайне). + +Готовую карту используем как чек-лист: сверка вёрстки и функционала нативного экрана идёт +по этому дереву.