b-dev-mobile
66 lines
4.6 KiB
Markdown
66 lines
4.6 KiB
Markdown
# Карта приложений (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-классов.
|
|
- Каждую кнопку/иконку — отдельной строкой с назначением. Если назначение неочевидно —
|
|
пометь `(?)` и опиши гипотезу.
|
|
- Модалки/шиты/выпадающие меню — тоже экраны, раскрывай их.
|
|
- Отмечай, где мобильная веб-версия отличается от того, что уже есть в нативном клиенте
|
|
(`расхождение:` …) — это сразу твой бэклог на добивку.
|
|
- Пустые состояния и состояния ошибки — фиксируй (это отдельные экраны в дизайне).
|
|
|
|
Готовую карту используем как чек-лист: сверка вёрстки и функционала нативного экрана идёт
|
|
по этому дереву.
|