From 9efb3595c0b978893e3c4fd8c5f7bac41057834c Mon Sep 17 00:00:00 2001
From: b-dev-mobile <b-dev-mobile@f7cloud.ru>
Date: Mon, 13 Jul 2026 09:32:13 +0000
Subject: [PATCH] =?UTF-8?q?docs(app-map):=20=D0=BA=D0=BE=D0=BD=D0=B2=D0=B5?=
 =?UTF-8?q?=D0=BD=D1=86=D0=B8=D1=8F=20=D1=8D=D1=82=D0=B0=D0=BB=D0=BE=D0=BD?=
 =?UTF-8?q?=D0=BD=D1=8B=D1=85=20=D0=B2=D0=B5=D0=B1-=D1=81=D0=BA=D1=80?=
 =?UTF-8?q?=D0=B8=D0=BD=D0=BE=D0=B2=20forbion=20=D0=B4=D0=BB=D1=8F=20Fd=20?=
 =?UTF-8?q?(360dp,=20iframe-=D1=82=D0=B5=D1=85=D0=BD=D0=B8=D0=BA=D0=B0,=20?=
 =?UTF-8?q?=D0=BF=D1=80=D0=B8=D0=B2=D0=B0=D1=82=D0=BD=D0=BE=D1=81=D1=82?=
 =?UTF-8?q?=D1=8C)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/app-map/reference/README.md | 35 ++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)
 create mode 100644 docs/app-map/reference/README.md

diff --git a/docs/app-map/reference/README.md b/docs/app-map/reference/README.md
new file mode 100644
index 0000000..d982f35
--- /dev/null
+++ b/docs/app-map/reference/README.md
@@ -0,0 +1,35 @@
+# Эталонные веб-скриншоты forbion (для Fd-сверки)
+
+Здесь лежат **эталонные скриншоты мобильной веб-версии forbion** — с ними Roborazzi-рендеры
+нативных экранов сравниваются попиксельно (метрика Fd, программа 1:1). Одна папка на приложение:
+`docs/app-map/reference/<app>/<screen>.png`.
+
+## Ширина — 360dp (Figma-фрейм)
+Рендер и эталон — **360dp** (не 390!). В screenshot-тестах Roborazzi:
+`@Config(sdk=[34], qualifiers="w360dp-h800dp-xxhdpi")`. Эталонный веб-скрин тоже снимать на
+ширине **360 CSS-px**.
+
+## Как снять мобильную вёрстку (важно!)
+`resize_window` НЕ ужимает вьюпорт общего Chrome (отдаёт десктоп 1480px). Снимаем через
+**same-origin iframe 360px** внутри страницы forbion ([[f7-mobile-web-iframe-technique]]):
+инжектируешь `<iframe width=360 src="/index.php/apps/<app>/…">` в открытую страницу forbion
+(Browser 1, сессия `cloude`), ждёшь загрузки, скриншотишь регион iframe. Мобильная тема
+включается по ширине iframe (у него свой вьюпорт 360px).
+
+## ⚠️ Приватность — НЕ светить реальные данные
+`cloude` — реальный рабочий аккаунт: на экранах видны настоящие файлы/письма/договоры/контакты.
+**В эталон НЕ коммитим реальные данные.** Снимаем:
+- пустые состояния, ИЛИ
+- свои тест-объекты `bmob-*` (mail/085), ИЛИ
+- кадрируем так, чтобы в кадре был только UI-каркас (шапки/панели/кнопки/меню), без реального
+  контента; персональные имена/суммы/адреса замазать/обрезать.
+Скрин с чужими реальными данными в git — недопустим.
+
+## Что снимать (по карте `<app>.md`)
+Каждый экран из карты + всплывающие меню (mail/087): список/деталь/форма/модалки/пустые
+состояния/контекстные «⋯». Имя файла = слаг экрана (`list.png`, `editor.png`, `menu-message.png`).
+
+## Кто заводит
+Владелец приложения (`b-mob-<x>`) снимает эталоны СВОИХ экранов и коммитит сюда; лид — оболочку
+(`shell/`). Затем — Roborazzi-тест нативного экрана → PNG → визуальное сравнение с этим эталоном,
+расхождения в `<app>.diff.md` (тип `Д`).