diff --git a/docs/UI-Design/PWA_VIEWPORT_AND_AVATAR_PREVIEW.md b/docs/UI-Design/PWA_VIEWPORT_AND_AVATAR_PREVIEW.md
new file mode 100644
index 00000000..096a570b
--- /dev/null
+++ b/docs/UI-Design/PWA_VIEWPORT_AND_AVATAR_PREVIEW.md
@@ -0,0 +1,21 @@
+# PWA: масштабирование страницы и просмотр аватара
+
+## Контракт поведения
+
+- В `shine-UI/index.html` viewport ограничен единичным масштабом: мобильное приложение не должно увеличиваться при разведении двух пальцев.
+- `styles/main.css` и `services/pwa-viewport-gestures.js` дополнительно отключают pinch-zoom, включая жесты Safari. Однопальцевая прокрутка, поля ввода и обычные свайпы остаются доступными.
+- Прокрутка `html/body` и оболочки приложения запрещена. `.screen-content` прокручивается **вертикально**, без горизонтального выхода за края и с ограничением scroll chaining. Ленты, длинные страницы, переписка и специализированные внутренние scroll-контейнеры сохраняют свою прокрутку. Не добавлять глобальный `touchmove.preventDefault()` для одиночного касания.
+- На **своём** (`pages/profile-view.js`) и **чужом** (`pages/user-profile-view.js`) профиле нажатие на большую аватарку открывает её поверх всего интерфейса. Нажатие на увеличенную аватарку или фон, Escape и браузерная навигация назад закрывают просмотр. При закрытии/размонтировании страницы временные обработчики удаляются.
+- `components/profile-avatar-preview.js` использует существующий `renderUserAvatar` и переносит **тот же DOM-элемент** во временное окно и обратно. Нельзя копировать URL изображения: загрузчик фото из Arweave может отозвать `blob:` после загрузки; повторный запрос также не нужен. Инициалы при отсутствии фотографии продолжают работать.
+- Надписи для доступности находятся в словарях `js/i18n/locales/{ru,en}.json`; просмотр открывается обычной кнопкой и закрывается кнопкой/клавишей Escape.
+
+## Ограничение
+
+Отключение масштабирования страницы снижает доступность для людей, которым необходим pinch-zoom. Это осознанное ограничение интерфейса PWA по текущему требованию продукта; для дальнейшего развития стоит рассмотреть отдельно управляемый параметр «Разрешить масштабирование» в настройках доступности.
+
+## Проверить на устройствах
+
+1. Android Chrome / PWA, iOS Safari / PWA: два пальца не увеличивают/не уменьшают всю страницу, жест прокрутки и клавиатура работают как раньше.
+2. На своём и чужом профиле фотография открывается крупно, повторное нажатие закрывает, инициалы без фотографии также отображаются.
+3. Назад / Escape, переключение экрана, обновление данных профиля во время просмотра не оставляют висящих окон.
+4. Лента, длинный профиль и чат прокручиваются внутри приложения; горизонтального сдвига корневой страницы нет.
diff --git a/docs/UI-Design/README.md b/docs/UI-Design/README.md
index bc67df86..215e84cb 100644
--- a/docs/UI-Design/README.md
+++ b/docs/UI-Design/README.md
@@ -8,6 +8,7 @@
Галерея сохранена без изменений и ещё не отражает итоговое сочетание решений. Для последующего переноса источником истины служит `DESIGN.md`, а не детали одного старого варианта. Эта галерея не является описанием текущего кода приложения.
- [Локализация UI (этап 1)](I18N.md) — языковой движок, приоритет системного языка и глобальные настройки.
+- [PWA: масштабирование и аватар профиля](PWA_VIEWPORT_AND_AVATAR_PREVIEW.md) — поведение полноэкранного интерфейса и просмотра фотографии.
- [Заявления о статусах и предупреждения о блокчейне](PROFILE_DECLARATIONS_AND_CONSENT.md) — действующие сценарии профиля, лайков и подтверждений на 06.11.2026.
## Как посмотреть
diff --git a/shine-UI/index.html b/shine-UI/index.html
index fbe9450f..6c86841b 100644
--- a/shine-UI/index.html
+++ b/shine-UI/index.html
@@ -4,7 +4,7 @@
@@ -39,7 +39,7 @@
}());