user/user-guide.md

@@ -1,16 +1,18 @@
-# Инструкция пользователя АРМ КА (прототип)
+# АРМ КА — Инструкция пользователя
 
-Документ описывает работу с текущей версией приложения **АРМ КА** — автоматизированного рабочего места кредитного
+АРМ КА — автоматизированное рабочее место кредитного аналитика ДКБ. Эта инструкция поможет создать консолидацию,
-аналитика ДКБ: фронт `arm-web` (ветка `test`) и ядро `arm-core` (`main`) по состоянию на 09.10.2026. Снимки экранов
+загрузить и проверить документы, получить сводную оборотно-сальдовую ведомость (ОСВ) и выгрузить её в Excel. На снимках
-сделаны на локальном стенде с демо-данными группы компаний «Русский Бисквит» (окно браузера 1600×1000); на вашем стенде
+экранов приведены демонстрационные данные группы компаний «Русский Бисквит»; названия организаций, даты и суммы в вашем
-названия организаций, даты и суммы могут отличаться, устройство экранов — то же.
+интерфейсе могут отличаться.
 
-Для кого: аналитик, который проверяет приложение или работает в нём впервые. Как поднять стенд, какие учётные записи
+Инструкция описывает фронт `arm-web` (ветка `test`) и ядро `arm-core` (`main`) по состоянию на 20.10.2026. Как поднять
-есть и как заводить дефекты — в гайде тестировщика [`../dev/qa-guide.md`](../dev/qa-guide.md) (разделы 4, 4.4 и 11);
+стенд, какие учётные записи есть и как заводить дефекты — в гайде тестировщика
-здесь только путь пользователя по экранам.
+[`../dev/qa-guide.md`](../dev/qa-guide.md).
 
 ## Содержание
 
+- [Основные понятия](#основные-понятия)
+- [Быстрый старт](#быстрый-старт)
 1. [Что умеет текущая версия](#1-что-умеет-текущая-версия)
 2. [Вход в систему](#2-вход-в-систему)
 3. [Устройство интерфейса](#3-устройство-интерфейса)
@@ -21,10 +23,48 @@
 8. [Просмотр ОСВ](#8-просмотр-осв)
 9. [Проверка форм ББ и ОФР](#9-проверка-форм-бб-и-офр)
 10. [Сводная ОСВ](#10-сводная-осв)
-11. [Администрирование: пользователи и роли](#11-администрирование-пользователи-и-роли)
+11. [Справочники: группы компаний и организации](#11-справочники-группы-компаний-и-организации)
-12. [Статусы и термины](#12-статусы-и-термины)
+12. [Администрирование: пользователи и роли](#12-администрирование-пользователи-и-роли)
-13. [Ограничения текущей версии](#13-ограничения-текущей-версии)
+13. [Статусы и термины](#13-статусы-и-термины)
-14. [Если что-то пошло не так](#14-если-что-то-пошло-не-так)
+14. [Ограничения и известные ошибки](#14-ограничения-и-известные-ошибки)
+15. [Если что-то пошло не так](#15-если-что-то-пошло-не-так)
+
+## Основные понятия
+
+Консолидация — работа с отчётностью выбранных организаций группы за указанные год и квартал для получения общего
+результата. В текущей версии основной доступный результат — сводная ОСВ.
+
+Версия — конкретный вариант консолидации со своим составом организаций и статусом. При создании появляется версия 1;
+функция добавления новой версии пока недоступна. Перед загрузкой документов выбирайте нужную версию в таблице
+консолидаций. Загружать документы можно только в версию «в работе» — в статусе «Инициация», «Обработка документов» или
+«Коррекция данных».
+
+Периметр — список организаций, включённых в выбранную версию и её расчёт. При создании его задают галочками в блоке «ЮЛ
+консолидации».
+
+ГСК — группа связанных компаний внутри выбранной ГК. Выбирайте ГСК, указанную в задании на расчёт. Её участники
+отмечаются автоматически, но перед созданием проверьте весь периметр.
+
+## Быстрый старт
+
+Маршрут: вход → выбор ГК → создание консолидации → загрузка → проверка → свод → выгрузка.
+
+1. Войдите в приложение по инструкции раздела 2.
+2. Откройте «Отчётность → Группы компаний», найдите нужную ГК и нажмите «Консолидации» (разделы 4 и 5).
+3. Если нужной консолидации нет, нажмите «+ Новая консолидация», выберите ГК, ГСК, год и квартал, проверьте состав
+   организаций и нажмите «Создать» (раздел 6). Если она уже есть, выберите нужную версию.
+4. В выбранной версии откройте «Документы» нужной организации и загрузите её файлы. Повторите для остальных организаций;
+   дождитесь обработки (раздел 7).
+5. Проверьте распознанные данные по исходникам, период, организацию и единицы измерения. При необходимости исправьте ББ
+   и ОФР и подтвердите документы. Документы без замечаний — и ОСВ, и формы ББ/ОФР — подтверждаются автоматически
+   (разделы 8 и 9).
+6. Нажмите «К отчётности →» в строке версии. В сводной ОСВ проверьте пробелы по кварталам и сопоставьте контрагентов без
+   ИНН (раздел 10).
+7. Установите нужные фильтры и выгрузите свод в XLSX. Выгрузка учитывает текущие фильтры; для полного свода
+   предварительно сбросьте их (раздел 10).
+
+Результат этого маршрута — проверенная сводная ОСВ и её выгрузка. Формирование КФО и маршрут согласования в текущей
+версии ещё недоступны.
 
 ## 1. Что умеет текущая версия
 
@@ -32,23 +72,27 @@
 
 - список групп компаний (ГК) с поиском и фильтрами;
 - создание консолидации за квартал: ГК, группа связанных компаний (ГСК), год, квартал, состав юридических лиц (ЮЛ);
-- страница ГК: список консолидаций и версий, состав организаций версии, чек-лист документов в CSV;
+- страница ГК: список консолидаций и версий, состав организаций версии, окно «Чеклист» с выгрузкой в CSV;
-- загрузка первичных документов по каждому ЮЛ: ОСВ в Excel (`xls`, `xlsx`, `xlsb`), бухгалтерский баланс (ББ) и отчёт
+- загрузка первичных документов по каждому ЮЛ: ОСВ в Excel (`xls`, `xlsx`, `xlsb`), бухгалтерский баланс (ББ) и отчёт о
-  о финансовых результатах (ОФР) в PDF и Excel; тип документа и период определяются автоматически;
+  финансовых результатах (ОФР) в PDF и Excel; тип документа и период определяются автоматически;
+- удаление ошибочного файла и замена файла актуальной версией;
+- предупреждения распознавания у файла, документа, строки и ячейки;
 - просмотр распознанной ОСВ (только чтение) и подтверждение документа;
-- проверка форм ББ/ОФР рядом со сканом: правка значений, логические проверки, принятие нарушений с комментарием,
+- проверка форм ББ/ОФР рядом со сканом: правка значений и шапки, разбор строк без кода и расшифровок, подтверждение
-  подтверждение;
+  отдельных значений, логические проверки, принятие нарушений с комментарием, подтверждение формы;
+- комментарий к документу;
 - сводная ОСВ по версии: фильтры, список пробелов по кварталам, тип контрагента (ГСК / ГК / Внешний), сопоставление
   контрагента без ИНН с организацией справочника, экспорт в Excel;
+- справочники: группы компаний, ЮЛ, ГСК и ГСЗ — просмотр, создание, изменение, перевод ЮЛ в другую ГК и вывод из ГК;
 - администрирование: пользователи, роли, матрица «роль × право».
 
-Чего в этой версии **нет** (пункты меню и вкладки показаны, но не работают — см. раздел 13): шахматка, таблица
+Чего в этой версии **нет** (пункты меню и вкладки показаны, но не работают — см. раздел 14): шахматка, таблица
-корректировок, гудвилл, КФО, маршрут согласования и смена статусов вручную, Единое хранилище, журнал действий, экраны
+корректировок, гудвилл, КФО, маршрут согласования и смена статусов вручную, Единое хранилище, журнал действий,
-справочников ГК/ЮЛ, монозаёмщики. Вход через корпоративный SSO заменён формой входа для разработки.
+монозаёмщики, просмотр комментариев. Вход через корпоративный SSO заменён формой входа для разработки.
 
 ## 2. Вход в систему
 
-Откройте адрес стенда (на локальном стенде — `http://localhost:3000/`). Появится форма «Вход для разработки».
+Появится форма «Вход для разработки».
 
 ![Форма входа](img/01-login.png)
 
@@ -56,7 +100,7 @@
 2. Нажмите «Войти (dev)».
 
 Список учётных записей стенда и их ролей — `qa-guide.md`, раздел 4.4. Для прохода по этой инструкции достаточно
-`ka_go@armka.local` (аналитик головного офиса, роль KA_GO); раздел 11 требует `admin@armka.local`.
+`ka_go@armka.local` (аналитик головного офиса, роль KA_GO); раздел 12 требует `admin@armka.local`.
 
 После входа открывается главная страница с ФИО пользователя и его ролями.
 
@@ -70,8 +114,8 @@
 
 ## 3. Устройство интерфейса
 
-Слева — боковое меню, справа — рабочая область с «хлебными крошками» (например, «Отчётность › Группы компаний»)
+Слева — боковое меню, справа — рабочая область с «хлебными крошками» (например, «Отчётность › Группы компаний») и
-и кнопкой «← Назад» на вложенных экранах.
+кнопкой «← Назад» на вложенных экранах.
 
 Меню:
 
@@ -80,10 +124,11 @@
 | — | **+ Новая консолидация** | окно создания консолидации (раздел 6) |
 | Отчётность | Группы компаний | список ГК (раздел 4) — основной вход в работу |
 | Отчётность | Монозаемщики | заглушка |
-| Справочники | ГК и организации, ЮЛ вне ГК | заглушки |
+| Справочники | ГК и организации | справочник групп компаний, ЮЛ, ГСК и ГСЗ (раздел 11) |
+| Справочники | ЮЛ вне ГК | организации, не входящие ни в одну ГК (раздел 11) |
 | Документы | Единое хранилище | заглушка |
 | Система | Журнал действий | заглушка |
-| Система | Пользователи и роли | администрирование (раздел 11) |
+| Система | Пользователи и роли | администрирование (раздел 12) |
 
 Кнопка «‹» в шапке меню сворачивает его до иконок; «›» разворачивает обратно.
 
@@ -93,9 +138,10 @@
 
 ![Заглушка «Монозаёмщики»](img/43-stub-mono.png)
 
-Общие элементы таблиц: строка поиска над таблицей, воронка в заголовке колонки — фильтр по этой колонке (зелёная
+Общие элементы таблиц: строка поиска над таблицей, воронка в заголовке колонки — фильтр по этой колонке (зелёная воронка
-воронка — фильтр активен), «Настройка таблицы» — выбор видимых колонок, «Сбросить фильтры» появляется, когда хотя бы
+— фильтр активен), «Настройка таблицы» — выбор видимых колонок, «Сбросить фильтры» появляется, когда хотя бы один фильтр
-один фильтр применён. Уведомления об успехе и ошибках появляются вверху экрана и исчезают через несколько секунд.
+применён. Уведомления об успехе и ошибках появляются вверху экрана и исчезают через несколько секунд; на экранах
+справочников ошибки показываются внизу справа.
 
 ## 4. Группы компаний
 
@@ -113,32 +159,41 @@
 
 ![Страница группы компаний](img/04-group-page.png)
 
-**Консолидации** — все консолидации группы, по строке на версию: «Год», «Квартал» (К1…К4), «Версия» (номер),
+**Консолидации** — все консолидации группы, по строке на версию: «Год», «Квартал» (К1…К4), «Версия» (номер), «Статус»
-«Статус» (цветной бейдж, раздел 12), «ГСК», «Дата создания», «Дата верификации», «Организаций» (размер периметра).
+(цветной бейдж, раздел 13), «ГСК», «Дата создания», «Дата верификации», «Организаций» (размер периметра). Клик по строке
-Клик по строке выбирает версию: строка подсвечивается зелёным, адрес страницы получает `?version=<id>`, а блок
+выбирает версию: строка подсвечивается зелёным, адрес страницы получает `?version=<id>`, а блок «Организации»
-«Организации» заполняется составом этой версии.
+заполняется составом этой версии.
 
 ![Выбранная версия](img/08-group-version-selected.png)
 
+Если консолидаций ещё нет, блок «Организации» будет пустым, даже когда в группу входят юридические лица. Создайте
+консолидацию по разделу 6. Если консолидации есть, выберите строку нужной версии: после этого появится состав
+организаций и станет доступна панель документов.
+
 В строке версии:
 
 - «К отчётности →» — переход к сводной ОСВ версии (раздел 10);
-- меню «⋮»: «Добавить версию» (в прототипе отвечает «Будет позже»), «Отключить подтверждение КФО» и «История
+- меню «⋮»: «Добавить версию» и «Отключить подтверждение КФО» (в прототипе отвечают «Будет позже»), «История изменений»
-  изменений» (заглушки).
+  (открывает заглушку «Журнал действий»).
 
 ![Меню строки версии](img/09-version-row-menu.png)
 
-**Организации** — периметр выбранной версии. Над таблицей: «Ответственный» (кто создал версию), «Утверждён в РФ» и
+**Организации** — периметр выбранной версии. Над таблицей: «Ответственный» (кто взял версию в работу, а если её никто не
-«Верифицирован в ГО» (в этой версии всегда «—»), кнопки «Настройка таблицы» и «Скачать чек-лист». Колонки:
+взял — кто её создал), «Утверждён в РФ» и «Верифицирован в ГО» (в этой версии всегда «—»), кнопки «Настройка таблицы» и
-«Наименование», «Документы» (кнопка открытия панели документов, раздел 7), «ОФР» и «Бух.баланс» (статус формы за
+«Скачать чек-лист». Колонки: «Наименование», «Документы» (кнопка открытия панели документов, раздел 7), «ОФР» и
-отчётный период: «Отсутствует», «Обработка», «Требуется проверка», «Загружен»), «ОСВ» (счета, по которым загружены
+«Бух.баланс» (статус формы за отчётный период: «Отсутствует», «В обработке», «Распознан», «Требуется проверка»,
-ведомости), «ИНН», «Тип» (ЮЛ / ИП).
+«Загружен», «Ошибка»), «ОСВ» (счета, по которым загружены ведомости), «ИНН», «Тип» (ЮЛ / ИП).
 
-«Скачать чек-лист» сохраняет файл `checklist-<ГК>-<год>-Q<квартал>.csv` (разделитель `;`, открывается в Excel) со
+«Скачать чек-лист» открывает окно «Чеклист»: по строке на каждое ЮЛ периметра и по колонке на каждый требуемый документ
-статусом каждого требуемого документа по каждому ЮЛ периметра. Кнопка активна только при выбранной версии.
+— «Бух.баланс», «ОФР» и ОСВ по счетам (01, 58, 60, 62, 66, 67, 76, 90). В ячейках — значки статуса, расшифровка значков
+— в строке «Условные обозначения» над таблицей. ОСВ отмечается как «Отсутствует», если за какой-либо квартал периода её
+нет (см. «Пробелы» в разделе 10). Кнопка «Скачать чек-лист» в окне сохраняет файл `checklist-<ГК>-<год>-Q<квартал>.csv`
+(разделитель `;`, открывается в Excel) и закрывает окно. Кнопка на странице активна только при выбранной версии.
 
-Таблица консолидаций обновляется при перезагрузке страницы (F5): сразу после создания консолидации новая строка может
+![Окно «Чеклист»](img/50-checklist-modal.png)
-появиться только после обновления.
+
+Новая консолидация появляется в таблице сразу после создания. Смена статуса версии (например, на «Коррекция данных»
+после загрузки документов) видна после перезагрузки страницы (F5).
 
 ## 6. Новая консолидация
 
@@ -149,7 +204,8 @@
 Заполните поля по порядку:
 
 1. «Группа компаний» — ГК из списка доступных вам.
-2. «ГСК» — группа связанных компаний внутри ГК (поле активно после выбора ГК).
+2. «ГСК» — группа связанных компаний внутри ГК (поле активно после выбора ГК). Выберите ГСК по заданию на расчёт; если
+   выбор неясен, уточните его у ответственного за расчёт.
 3. «Год» — текущий и три предыдущих.
 4. «Квартал» — 1–4 квартал.
 
@@ -159,8 +215,8 @@
 
 ![Заполненное окно с составом ЮЛ](img/06-new-consolidation-filled.png)
 
-«Создать» создаёт консолидацию и версию 1 в статусе «Инициация», показывает уведомление «Создана консолидация <год>,
+«Создать» создаёт консолидацию и версию 1 в статусе «Инициация», показывает уведомление «Создана консолидация \<год\>,
-<квартал>» и открывает страницу ГК с выбранной версией.
+\<квартал\>» и открывает страницу ГК с выбранной новой версией.
 
 ![Консолидация создана](img/07-consolidation-created.png)
 
@@ -175,20 +231,36 @@
 ## 7. Первичные документы: загрузка и статусы
 
 Документы загружаются по каждой организации отдельно. На странице ГК выберите версию и нажмите «Документы» в строке
-организации (или кликните по строке). Справа откроется панель «ПЕРВИЧНЫЕ ДОКУМЕНТЫ» с названием и ИНН организации и
+организации (или кликните по строке). Справа откроется панель «ПЕРВИЧНЫЕ ДОКУМЕНТЫ» с названием и ИНН организации.
-списком всех её файлов (не только текущего периода).
+
+По умолчанию панель показывает документы этой организации, относящиеся к выбранной консолидации: загруженные в неё, а
+также ОСВ предыдущих кварталов, которые нужны для периода версии (например, для консолидации за 2 квартал — ОСВ за 1 и 2
+кварталы). Переключатель «Все документы организации» над таблицей показывает все файлы организации — подробнее в разделе
+7.3.
 
 ![Панель первичных документов](img/10-documents-panel.png)
 
 Колонки панели: «Документ» (имя файла; под ним — тип документа, формат и дата загрузки, например «ОСВ 60 · XLS ·
-09.10.2026»), «Период» (определённый из документа, например «2024 К3»), «Проверка» (две отметки: «Период» и
+20.10.2026»), «Период» (определённый из документа, например «2024 К3»), «Проверка» (две отметки: «Период» и «Контрагент»
-«Контрагент» — совпадает ли организация в шапке документа с ЮЛ, на которое он загружен: ✓ совпадает, ✗ не совпадает,
+— совпадает ли организация в шапке документа с ЮЛ, на которое он загружен: ✓ совпадает, ✗ не совпадает, «—» не
-— не проверялось), «Статус» (раздел 12). Крестик в правом верхнем углу закрывает панель.
+проверялось), «Статус» (раздел 13; под статусом — значок с числом предупреждений, раздел 7.4) и кнопка-корзина для
+удаления или замены файла (раздел 7.5). Крестик в правом верхнем углу закрывает панель.
+
+Отметка «Период» временно не вычисляется и всегда показывает «—»: пока сверяйте период документа с периодом версии по
+колонке «Период».
+
+Клик по строке открывает документ: ОСВ — на экране «Просмотр ОСВ» (раздел 8), ББ и ОФР — на экране «Проверка
+распознавания» (раздел 9). Если документ открыть нельзя (расшифровка, прочий документ, файл ещё в обработке или с
+ошибкой), появится уведомление «Просмотр данного документа недоступен».
 
 ### 7.1 Загрузка
 
+Загрузка возможна только в версию «в работе» (статусы «Инициация», «Обработка документов», «Коррекция данных»). В других
+статусах кнопка «Загрузить документы» неактивна, а при наведении появляется подсказка «Загрузка доступна только в версии
+в работе».
+
 1. «Загрузить документы» → окно «Загрузка документов».
-2. Перетащите файлы в область или нажмите «Выбрать документы». Принимаются ОСВ, ББ и ОФР в форматах `xls`, `xlsx`,
+2. Переместите файлы в область или нажмите «Выбрать документы». Принимаются ОСВ, ББ и ОФР в форматах `xls`, `xlsx`,
    `xlsb`, `pdf`, `png`, `jpg`; тип документа и период система определяет сама.
 
 ![Окно загрузки](img/11-upload-modal-empty.png)
@@ -201,130 +273,276 @@
 ![Файлы приняты](img/13-upload-accepted.png)
 
 4. «Готово» закрывает окно. Принятые файлы появляются в панели со статусом «Обработка»; панель сама опрашивает сервер
-   раз в 5 секунд, пока есть файлы в обработке. Распознавание Excel-ОСВ занимает 5–15 секунд, PDF — до минуты.
+   раз в 5 секунд, пока есть файлы в обработке. Время распознавания зависит от объёма файла и загрузки стенда. Для
+   тестовых документов ориентир — 5–15 секунд для Excel-ОСВ и до минуты для PDF; это не гарантированный срок обработки.
 
 ![Файлы в обработке](img/14-documents-panel-processing.png)
 
-Когда распознавание завершено, у каждого файла заполняются тип, период и проверки; чистые ОСВ (период распознан,
+Когда распознавание завершено, у каждого файла заполняются тип, период и проверки. Документы без замечаний (организация
-организация совпала) подтверждаются автоматически и получают статус «Загружен».
+совпала, нет нарушений и препятствий подтверждению) подтверждаются автоматически и получают статус «Загружен» — это
+касается и ОСВ, и форм ББ/ОФР.
 
 ![Документы распознаны](img/15-documents-panel-loaded.png)
 
-Повторная загрузка файла с тем же именем для того же ЮЛ отклоняется: «Отклонено: 1 — файл «…» уже загружен для этого
+Повторная загрузка файла с тем же содержимым для того же ЮЛ отклоняется независимо от имени файла: «Отклонено: 1 — файл
-ЮЛ», уведомление «Ни один файл не принят».
+«…» уже загружен для этого ЮЛ», уведомление «Ни один файл не принят». Переименование файла не позволяет загрузить дубль.
 
 ![Дубликат отклонён](img/16-upload-rejected-duplicate.png)
 
+Изменённый файл (с другим содержимым) принимается. После его распознавания работает автозамена: если у этого ЮЛ уже есть
+файл с документом того же типа, того же счёта ОСВ и того же периода, прежний файл заменяется новым и исчезает из панели
+— даже если его документы были подтверждены. Документы нового файла нужно проверить заново, если они не подтвердились
+автоматически. Заменить файл явно, с указанием причины, можно через корзину (раздел 7.5).
+
+Статус версии в таблице консолидаций меняется по мере работы с документами: после первого принятого файла — «Обработка
+документов», после первого подтверждённого документа или документа, требующего проверки, — «Коррекция данных». Ждать
+загрузки по всем организациям не нужно. Новый статус виден после F5.
+
 ### 7.2 Один файл — несколько документов
 
-PDF с бухгалтерской отчётностью даёт два документа: «Бух. баланс · PDF» и «ОФР · PDF». Если в скане другая
+Если PDF содержит бухгалтерский баланс и ОФР и обе формы распознаны, в панели появляются два документа: «Бух. баланс ·
-организация, у обоих будет «Контрагент ✗» и статус «Требуется проверка» — их нужно проверить вручную (раздел 9).
+PDF» и «ОФР · PDF». PDF с одной формой не обязан создавать два документа. Если в распознанной форме другая организация,
+у соответствующего документа будет «Контрагент ✗» и статус «Требуется проверка» — проверьте форму вручную по разделу 9.
+Система не запрещает подтвердить такую форму, поэтому решение остаётся за аналитиком.
 
 ![PDF распознан в два документа](img/18-documents-panel-pdf.png)
 
-После того как по всем организациям периметра загружены документы, статус версии в таблице консолидаций меняется:
+### 7.3 Все документы организации
-«Обработка документов», пока идёт распознавание, затем «Коррекция данных» (видно после F5).
+
+Переключатель «Все документы организации» показывает все файлы организации, независимо от консолидации и периода. У
+файлов, загруженных в другую консолидацию, во второй строке добавляется её период, например «· 2025 К1», а у файлов вне
+консолидаций — «вне консолидации». Каждое новое открытие панели возвращает переключатель в исходное положение.
+Заменённые файлы не показываются ни в одном режиме.
+
+![Все документы организации](img/54-documents-panel-all.png)
+
+### 7.4 Предупреждения
+
+Под статусом документа показывается значок с числом предупреждений: синий «i» — информация, красный «!» — ошибка. Клик
+по значку открывает окно «Предупреждения» с разделами «Предупреждения файла», «Предупреждения обработки» и
+«Предупреждения документа»; у каждой строки — метка «Информация» или «Ошибка».
+
+![Предупреждения документа](img/55-file-warnings.png)
+
+Информационные предупреждения не мешают работе. Например, у ОСВ часто встречается «иерархия строк — по группировке листа
+(outline)», у сканов — «ИНН не найден», «Дата отчёта не разобрана». Те же предупреждения показываются на экранах
+просмотра документа (разделы 8 и 9).
+
+### 7.5 Удаление и замена файла
+
+Кнопка-корзина в конце строки открывает окно «Удаление документа» с выбором причины. Удаление и замена действуют на файл
+целиком — со всеми его документами.
+
+![Удаление документа](img/56-delete-modal.png)
+
+- **«Ошибочный документ» → «Удалить»** — файл удаляется без возможности восстановления, уведомление «Файл удалён».
+  Сервер откажет, если в файле есть документы, подтверждённые пользователем вручную, если файл заменил более раннюю
+  версию или если документ привязан к версии консолидации вне корректировки данных — текст причины появится в
+  уведомлении.
+- **«Замена документа» → «Заменить»** открывает окно «Замена документа»: укажите причину замены (обязательно, до 4000
+  символов), перетащите новый файл в область или нажмите «Выбрать документ» и нажмите «Загрузить». Кнопка «Заменить»
+  активна только в версии «в работе».
+
+![Замена документа](img/57-replace-modal.png)
+
+После загрузки появится уведомление «Файл загружен: прежний будет заменён после разбора, если совпадут тип, счёт и
+период». Причина замены сохраняется комментарием к заменяемому документу.
 
 ## 8. Просмотр ОСВ
 
-Клик по строке ОСВ в панели документов открывает экран «Просмотр ОСВ»: крошки «Отчётность › <ЮЛ> › Проверка
+Клик по строке ОСВ в панели документов открывает экран «Просмотр ОСВ»: крошки «Отчётность › \<ЮЛ\> › Проверка
-документа», имя файла, формат и дата, справа — статус документа.
+документа», имя файла, формат и дата. Справа вверху — список «Документ» и статус документа, ниже — кнопка «Добавить
+комментарий».
 
 ![Просмотр ОСВ](img/17-osv-document.png)
 
-- Строки ОСВ только для чтения, суммы в рублях. Колонки: «Субсчёт», «Контрагент / аналитика», «ИНН», сальдо на начало
+- Строки ОСВ только для чтения, суммы в рублях. Колонки показываются по содержимому файла: «Субсчёт»; колонка аналитики
-  периода (Дебет / Кредит), обороты за период (Дебет / Кредит), сальдо на конец периода (Дебет / Кредит). Ноль
+  — «Контрагент», название вида аналитики из файла (например «Основные средства») или «Аналитика», если видов несколько;
-  показывается как «—».
+  «ИНН» — только если в ОСВ есть контрагенты; «Подразделение» — если оно есть в файле; далее сальдо на начало периода
-- Поле «Контрагент или ИНН» фильтрует строки, «Субсчёт» — выбор субсчёта; «Строк: N» — число строк после фильтра.
+  (Дебет / Кредит), обороты за период (Дебет / Кредит), сальдо на конец периода (Дебет / Кредит). Ноль показывается как
-- Внизу «Итого по документу».
+  «—».
-- «✓ Подтвердить» активна только для документа в статусе «Требуется проверка»; у автоматически подтверждённых ОСВ
+- Поле «Контрагент или ИНН» (или «Поиск по аналитике», если контрагентов нет) фильтрует строки, «Субсчёт» — выбор
+  субсчёта; «Строк: N» — число строк после фильтра.
+- Таблица прокручивается внутри экрана, внизу закреплена строка «Итого по документу».
+- Если у документа есть предупреждения, над таблицей показывается блок «Предупреждения (N)» (раздел 7.4).
+- «Подтвердить» активна только для документа в статусе «Требуется проверка»; у автоматически подтверждённых ОСВ
   («Загружен») она неактивна. Подтверждение переводит документ в «Загружен», после чего он участвует в сводной ОСВ.
 
+### 8.1 Переход между документами и комментарий
+
+Список «Документ» в шапке экрана содержит другие документы той же организации из той же консолидации — с типом,
+форматом, датой и статусом. Выбор пункта открывает этот документ без возврата к панели. Так же удобно переходить между
+ББ и ОФР одного файла.
+
+![Список «Документ»](img/52-document-select.png)
+
+«Добавить комментарий» открывает окно с полем «Комментарий» (до 4000 символов). «Добавить» сохраняет комментарий,
+уведомление «Комментарий добавлен». Комментарий можно оставить к документу в любом статусе; посмотреть сохранённые
+комментарии в текущей версии нельзя (раздел 14).
+
+![Добавить комментарий](img/53-comment-modal.png)
+
 ## 9. Проверка форм ББ и ОФР
 
-Клик по строке «Бух. баланс» или «ОФР» в панели документов открывает экран «Проверка распознавания». Слева —
+Клик по строке «Бух. баланс» или «ОФР» в панели документов открывает экран «Проверка распознавания». Шапка экрана — как
-«ИСХОДНЫЙ ДОКУМЕНТ»: страницы PDF с масштабом («−», «100%», «+», сброс). Справа — «РЕЗУЛЬТАТ РАСПОЗНАВАНИЯ».
+у просмотра ОСВ: список «Документ», статус, «Добавить комментарий» (раздел 8.1). Слева — «ИСХОДНЫЙ ДОКУМЕНТ»: страницы
+PDF с масштабом («−», «100%», «+», сброс). Справа — «РЕЗУЛЬТАТ РАСПОЗНАВАНИЯ».
 
 ![Проверка бухгалтерского баланса](img/19-review-bb.png)
 
 Правая часть сверху вниз:
 
-- шапка: «ИНН», «Дата отчёта», «Единица измерения». Нераспознанное значение — «—» на оранжевом фоне;
+- шапка: «Организация», «ИНН», «Дата отчёта», «Единица измерения». Нераспознанное значение — «—». Оранжевым фоном
-- название формы («Бухгалтерский баланс» / «Отчёт о финансовых результатах») и дата, если она есть;
+  выделяются только поля, которые система просит проверить; значок «i» или «!» рядом со значением — предупреждение,
-- блок проверок: зелёный «Проверки пройдены» или красный «Нарушения (N)» с формулами (раздел 9.2);
+  текст которого виден при наведении;
+- название формы («Бухгалтерский баланс» / «Отчёт о финансовых результатах») и дата «на ДД.ММ.ГГГГ», если она известна;
+- блок проверок: зелёный «Проверки пройдены» или красный «Нарушения (N)», жёлтый «Предупреждения проверок (N)» (раздел
+  9.3);
+- блок «Предупреждения (N)» — предупреждения распознавания с указанием места: строка, поле шапки, колонка. Ссылка
+  «Показать» прокручивает таблицу к нужной строке;
+- переключатели «Показать расшифровки (N)» и «Показать пустые строки детализации (N)» (раздел 9.1);
+- красная строка «Изменённых значений: X. Значений, требующих проверки: Y» — пока документ в статусе «Требуется
+  проверка»;
 - таблица формы: «Наименование показателя», «Код», колонки периодов как в документе. Разделы («АКТИВ», «I. Внеоборотные
-  активы» …) — серые полосы, итоговые строки — жирным, строки «БАЛАНС» (1600 и 1700) — фиолетовым фоном. Пустые
+  активы» …) — серые полосы, итоговые строки — жирным, строки «БАЛАНС» (1600 и 1700) — фиолетовым фоном.
-  значения — «-». Ячейка с уверенностью распознавания ниже 100 % подсвечена оранжевым, при наведении — «Уверенность:
-  N%». В форме показаны все строки шаблона, в том числе отсутствующие в источнике (пустые).
 
-Кнопки: «✎ Редактировать» и «✓ Подтвердить данные».
+Кнопки: «Редактировать» и «Подтвердить данные».
 
-Формы, загруженные в Excel, открываются тем же экраном, но слева вместо скана — «Превью недоступно для этого формата»
+Формы, загруженные в Excel, открываются тем же экраном, но слева вместо скана — «Превью недоступно для этого формата» и
-и кнопка «Скачать исходник».
+кнопка «Скачать исходник».
 
-### 9.1 Правка значений
+Суммы ББ и ОФР отображаются в единице измерения, указанной в шапке формы. При импорте Excel (`xls`, `xlsx`) учитываются
+числовые форматы ячеек, масштаб и округление исходного отчёта. Например, если Excel показывает 90 при единице «тыс.
+рублей», в результате распознавания также отображается 90, а не 90 000. Расходы, показанные в исходнике в скобках,
+сохраняют отрицательный знак; прочерк не заменяется скрытой ненулевой суммой. Для `xlsb` формат чисел не читается:
+значения берутся как они хранятся в файле, а у документа появляется предупреждение «формат чисел xlsb не читается».
 
-«✎ Редактировать» переводит таблицу и шапку в режим ввода; кнопки меняются на «✓ Сохранить» и «Отменить».
+### 9.1 Строки и значения формы
+
+В таблице есть строки нескольких видов:
+
+- **строка с кодом** — обычная строка формы. Если её наименование в файле отличается от справочного, справочное
+  показывается первым, а распознанное — второй строкой серым;
+- **строка без кода** — код не распознан или его нет в документе. Строка выделена красноватым фоном, в колонке «Код»
+  серым — распознанный текст или «—»; при наведении — «Код не распознан: «…»» или «Кода в строке нет»;
+- **расшифровка** — строка «в том числе», которая в суммы формы не входит. По умолчанию расшифровки скрыты, их
+  показывает переключатель «Показать расшифровки (N)»;
+- **подстрока (строка детализации)** — показывается с отступом сразу под своей строкой-родителем. Пустые подстроки
+  скрыты, их показывает переключатель «Показать пустые строки детализации (N)»;
+- **шаблонная строка** — строка формы, которой нет в документе: система достраивает форму по справочнику, такая строка
+  пустая. Ввод суммы в неё создаёт строку.
+
+![Строка без кода](img/58-review-nocode.png)
+
+Значения:
+
+- пустое значение — «-»; если сумма не распознана, а текст есть, вместо суммы серым показан распознанный текст (например
+  «(Ю4)»);
+- оранжевым подсвечены только значения, которые система просит проверить; низкая уверенность распознавания сама по себе
+  подсветку не включает;
+- при наведении на ячейку видно: «Исходное: …» (если значение исправлено), «Распознано: «…»», «Уверенность: N%», «Не
+  распознано как сумма: «…»», «Подтверждено аналитиком» и тексты предупреждений;
+- серая галочка слева от суммы — значение подтверждено аналитиком, значок «i» или «!» — у значения есть предупреждение.
+
+Если в форме есть строки без кода со значениями, над таблицей появляется ссылка «Разберите строки без кода: N», а
+«Подтвердить данные» неактивна, пока такие строки не разобраны (раздел 9.2).
+
+### 9.2 Правка значений
+
+«Редактировать» переводит таблицу и шапку в режим ввода; кнопки меняются на «Сохранить» и «Отменить». Все правки
+отправляются на сервер одним сохранением.
 
 ![Режим правки](img/20-review-edit.png)
 
 - Суммы вводятся числом (без пробелов, дробная часть через точку или запятую); знак «−» допустим.
-- Шапка: «ИНН», «Дата отчёта» строго в формате `ГГГГ-ММ-ДД`, «Единица измерения». Поля шапки можно заменить, но нельзя
+- Шапка: «Организация» (до 1000 символов), «ИНН» (10 или 12 цифр), «Дата отчёта» в формате `ГГГГ-ММ-ДД`, «Единица
-  очистить.
+  измерения». Поля шапки можно заменить, но нельзя очистить. У даты отчёта, которую система просит проверить, есть
+  кнопка «Подтвердить». Правка организации или ИНН пересчитывает проверку «Контрагент».
+- Рядом со значением, которое система просит проверить, есть кнопка-галочка «Подтвердить значение»; у подтверждённого —
+  «Снять подтверждение».
 - «Отменить» сбрасывает все несохранённые правки.
-- «✓ Сохранить» отправляет изменения: уведомление «Изменения сохранены», проверки пересчитываются. Исправленная ячейка
+- «Сохранить» отправляет изменения: уведомление «Изменения сохранены», проверки пересчитываются. Исправленная ячейка
-  подсвечивается голубым, при наведении видно «Исходное: <значение>» — распознанное значение не теряется.
+  подсвечивается голубым, при наведении видно «Исходное: \<значение\>» — распознанное значение не теряется.
 
 ![Правка шапки: дата отчёта](img/26-review-edit-header.png)
 
+**Меню строки «⋮».** В режиме правки рядом с наименованием строки есть кнопка «⋮» с действиями:
+
+- у строки без кода — «Это расшифровка»; чтобы назначить код, введите его в поле «Код» этой строки;
+- у расшифровки — «Назначить код»;
+- у строки с кодом — «Сделать расшифровкой», «Сменить код», а также «Подтвердить код» или «Снять подтверждение кода»;
+- после выбора действия — «Отменить изменение строки».
+
+Поле «Код» подсказывает варианты «\<код\> — \<наименование\>» из справочника формы. Код — 4 или 5 цифр. Выбранное
+действие отмечается в колонке «Код» меткой («→ расшифровка», «→ код подтверждён»). У шаблонных строк меню нет.
+
+![Меню строки](img/59-review-row-menu.png)
+
 Если в ячейке не число (например `abc`), она обводится красным с подсказкой «Неверный формат суммы», появляется
-уведомление «Исправьте суммы с неверным форматом», и запрос на сервер не уходит.
+уведомление «Исправьте суммы с неверным форматом», и запрос на сервер не уходит. Похожим образом отклоняются неверный
+код («Код — 4 или 5 цифр») и неверная дата колонки («Дата в формате ГГГГ-ММ-ДД»).
 
 ![Неверный формат суммы](img/25-review-invalid-format.png)
 
-### 9.2 Логические проверки и нарушения
+### 9.3 Логические проверки и нарушения
 
-После каждого сохранения система проверяет форму по контрольным соотношениям (итоги разделов, баланс актива и пассива,
+После каждого сохранения система проверяет форму по контрольным соотношениям: итоги разделов, баланс актива и пассива,
-связи строк ОФР). Нарушения показываются красным блоком «Нарушения (N)»: «Колонка N: <формула> — ожидалось X,
+связи строк ОФР. Нарушения показываются красным блоком «Нарушения (N)»: «Колонка N: \<формула\> — ожидалось X, получено
-получено Y». Жёлтый блок «Расхождения в пределах округления» — отклонения, которые не блокируют подтверждение.
+Y». Ссылка «Показать» прокручивает таблицу к строке и на пару секунд обводит её синей рамкой; ячейки, участвующие в
+нарушении, отмечены значком «!».
 
-![Нарушения после правки](img/21-review-violations.png)
+![Нарушения формы](img/21-review-violations.png)
 
-Пока есть нарушения, «✓ Подтвердить данные» отвечает красным блоком «не пройдены логические проверки формы: исправьте
+Жёлтый блок «Предупреждения проверок (N)» показывает соотношения, которые не блокируют подтверждение: мягкие проверки
+(например, «сумма подстрок = родитель») и расхождения в пределах округления. Жёлтый блок «Межформенная проверка ББ↔ОФР»
+сверяет показатели баланса и ОФР одного файла.
+
+Пока есть нарушения, «Подтвердить данные» отвечает красным блоком «не пройдены логические проверки формы: исправьте
 значения или акцептуйте с комментарием» с тем же списком, документ не подтверждается.
 
 ![Подтверждение заблокировано нарушениями](img/22-review-confirm-blocked.png)
 
-Два пути: исправить значения (раздел 9.1) или принять нарушения осознанно — «Принять с комментарием». В окне
+Два пути: исправить значения (раздел 9.2) или принять нарушения осознанно — «Принять с комментарием». В окне «Принять
-«Принять нарушения» комментарий обязателен (до 2000 символов), без него «Принять» неактивна.
+нарушения» комментарий обязателен (до 2000 символов), без него «Принять» неактивна. Пока есть несохранённые правки,
+«Принять с комментарием» неактивна с подсказкой «Сначала сохраните изменения».
 
 ![Окно принятия нарушений](img/23-review-accept-modal.png)
 
 После принятия под нарушениями появляется синий блок «Нарушения приняты» с датой, временем и комментарием; подтверждение
-становится возможным. Любая новая правка значений сбрасывает принятие — нарушения нужно принять заново.
+становится возможным. Правка данных — сумм, кодов строк, шапки — сбрасывает принятие, и нарушения нужно принять заново.
+Подтверждение отдельных значений и дат принятие не сбрасывает.
 
 ![Нарушения приняты](img/24-review-accepted.png)
 
-### 9.3 Подтверждение
+### 9.4 Подтверждение
 
-Для подтверждения в шапке должна быть «Дата отчёта» на конец квартала (например `2025-06-30`). Если дата пустая или не
+«Подтвердить данные» подтверждает документ, если для этого нет препятствий: уведомление «Документ подтверждён», статус
-на конец квартала, «✓ Подтвердить данные» показывает красный блок с текстом сервера и подсказкой «Исправьте дату отчёта
+«Загружен», кнопки «Редактировать» и «Подтвердить данные» становятся неактивными — дальнейшая правка невозможна.
-в шапке и сохраните».
-
-Когда проверки пройдены (или нарушения приняты) и дата указана, «✓ Подтвердить данные» подтверждает документ:
-уведомление «Документ подтверждён», статус «Загружен», кнопки «Редактировать» и «Подтвердить данные» становятся
-неактивными — дальнейшая правка невозможна.
 
 ![Документ подтверждён](img/27-review-confirmed.png)
 
+Система проверяет по порядку и показывает красный блок с причиной, если:
+
+| Причина | Текст | Что сделать |
+|---|---|---|
+| Не определён период формы | «у формы не определён период: поправьте дату отчёта» и подсказка «Исправьте дату отчёта в шапке и сохраните» | укажите «Дату отчёта» на конец квартала (например `2025-06-30`) и сохраните |
+| Есть строки без кода со значениями | «в форме есть нераспознанные строки со значениями: назначьте код или отметьте строку расшифровкой» и ссылка «Разберите строки без кода: N» | назначьте код или отметьте строку расшифровкой (раздел 9.2) |
+| Форма этого типа и периода в файле уже подтверждена | «форма этого типа и периода в файле уже подтверждена» и ссылка «Открыть подтверждённую форму» | проверьте подтверждённую форму |
+| Есть нарушения логических проверок | «не пройдены логические проверки формы…» | исправьте значения или примите нарушения (раздел 9.3) |
+
+Если «Дата отчёта» пуста, период формы определяется по датам колонок, поэтому пустая дата не всегда мешает
+подтверждению.
+
 ОФР того же файла открывается отдельным документом с колонками периодов ОФР («За январь – июнь 2025 г.» и т. п.);
 правила проверки и подтверждения те же.
 
 ![Проверка ОФР](img/28-review-ofr.png)
 
+![ОФР подтверждён после принятия нарушений](img/29-review-ofr-confirmed.png)
+
 ## 10. Сводная ОСВ
 
-Нажмите «К отчётности →» в строке версии. Откроется экран «<ГК> — <год> К<квартал>» со статусом отчёта в правом
+Нажмите «К отчётности →» в строке версии. Откроется экран «\<ГК\> — \<год\> К\<квартал\>» со статусом отчёта в правом
 верхнем углу и вкладками: «ОСВ» (активна), «Шахматка», «Таблица корректировки», «Гудвилл», «КФО», «КФО Общий»,
 «Подтверждение КФО клиента» (неактивны, подсказка «Будет в следующих срезах»).
 
@@ -334,14 +552,14 @@ PDF с бухгалтерской отчётностью даёт два док
 
 - **Жёлтый баннер «Требуется указать соответствия»** — сколько строк с внешними контрагентами без ИНН ещё не
   сопоставлено («Осталось: N»); кнопка «Показать ЮЛ без ИНН» включает фильтр только по таким строкам (раздел 10.3).
-- **«Пробелы: N»** — свёрнутый список счетов, по которым за часть кварталов периода нет ОСВ; строки таких счетов в
+- **«Пробелы: N»** — свёрнутый список счетов, по которым за часть кварталов периода нет ОСВ; строки таких счетов в свод
-  свод не попадают. Клик раскрывает список: «<ЮЛ> — счёт <код> — нет кварталов: Q1, Q2».
+  не попадают. Клик раскрывает список: «\<ЮЛ\> — счёт \<код\> — нет кварталов: Q1, Q2».
 
 ![Список пробелов](img/31-osv-gaps.png)
 
 - **Таблица**: «Компания ГК», «Счёт» (субсчёт), «Период» (например «9 мес. 2024 г.»), «Контрагенты», «ИНН», сальдо на
-  начало, обороты, сальдо на конец (Дебет / Кредит), «Тип контрагента». Суммы в рублях с копейками, ноль — «—».
+  начало, обороты, сальдо на конец (Дебет / Кредит), «Тип контрагента». Суммы в рублях с копейками, ноль — «—». По 500
-  По 500 строк на страницу, внизу «Строк: N» — общее число строк по текущим фильтрам и переключатель страниц. Таблица
+  строк на страницу, внизу «Строк: N» — общее число строк по текущим фильтрам и переключатель страниц. Таблица
   прокручивается по горизонтали.
 - **«Экспорт»** — сохраняет `svod-osv_<ГК>_<год>-Q<квартал>_v<версия>.xlsx` с листами «Сводная ОСВ» и «Пробелы» по
   текущим фильтрам.
@@ -368,8 +586,8 @@ PDF с бухгалтерской отчётностью даёт два док
 
 ![Фильтр по счёту](img/38-osv-filter-account.png)
 
-Пример: организация «ПЕКАРНЯ СЧАСТЛИВОЧНАЯ» и контрагент `бисквит` оставляют строки расчётов с «РУССКИЙ БИСКВИТ, АО»
+Пример: организация «ПЕКАРНЯ СЧАСТЛИВОЧНАЯ» и контрагент `бисквит` оставляют строки расчётов с «РУССКИЙ БИСКВИТ, АО» по
-по счетам 60, 62, 76 — это внутригрупповые обороты.
+счетам 60, 62, 76 — это внутригрупповые обороты.
 
 ![Отфильтрованные строки](img/34-osv-filtered.png)
 
@@ -386,17 +604,17 @@ PDF с бухгалтерской отчётностью даёт два док
 
 - ИНН из файла — просто число моноширинным шрифтом;
 - красная кнопка «Указать» на подсвеченном фоне — в файле ИНН нет и контрагент не связан с организацией справочника;
-- серая «таблетка» с ИНН — в файле ИНН не было, но контрагент уже связан с организацией справочника (подсказка
+- серая «таблетка» с ИНН — в файле ИНН не было, но контрагент уже связан с организацией справочника (подсказка «Связано
-  «Связано с организацией справочника — изменить»).
+  с организацией справочника — изменить»).
 
 «Показать ЮЛ без ИНН» в баннере оставляет только строки с «Указать»; кнопка меняется на «Показать все строки».
 
 ![Только строки без ИНН](img/36-osv-no-inn.png)
 
-Клик по «Указать» (или по серой таблетке) открывает окно «Выбор организации для связи с <контрагент>»:
+Клик по «Указать» (или по серой таблетке) открывает окно «Выбор организации для связи с \<контрагент\>»:
 
-1. Введите часть названия или ИНН в поле поиска. По умолчанию поиск идёт по организациям ГК и периметра; галочка
+1. Введите часть названия или ИНН в поле поиска. По умолчанию поиск идёт по организациям ГК и периметра; галочка «Искать
-   «Искать во всём справочнике (не только в группе)» расширяет его на весь справочник (нужно не меньше трёх символов).
+   во всём справочнике (не только в группе)» расширяет его на весь справочник (нужно не меньше трёх символов).
 2. В таблице — «ИНН», «Организация», «ГК», «ГСК», «ГСЗ» и кнопка «Связать»; у уже связанной организации — неактивное
    «Связано». Рекомендуемые совпадения показываются первыми.
 3. «Связать» сохраняет связь: имя контрагента из ОСВ закрепляется за организацией как псевдоним, строка получает ИНН и
@@ -404,15 +622,65 @@ PDF с бухгалтерской отчётностью даёт два док
 
 ![Окно выбора организации](img/37-osv-map-modal.png)
 
-Сопоставление — правка версии, для неё нужна ваша блокировка (создание версии её не берёт). Если версия ещё не
+Сопоставление — правка версии, для неё нужна ваша блокировка (создание версии её не берёт). Если версия ещё не взята
-взята вами в работу, перед первой связью система спросит «Взять версию в работу?» с пояснением, что пока блокировка у вас, другие пользователи не смогут править версию;
+вами в работу, перед первой связью система спросит «Взять версию в работу?» с пояснением, что пока блокировка у вас,
-«Взять в работу» продолжает, «Отмена» прерывает. Если версия уже в работе у другого пользователя, связь невозможна —
+другие пользователи не смогут править версию; «Взять в работу» продолжает, «Отмена» прерывает. Если версия уже в работе
-появится сообщение с его именем.
+у другого пользователя, связь невозможна — появится сообщение «Версию держит \<ФИО\>: правки недоступны, пока блокировка
+не снята».
 
-Связь действует на все версии, в которые входит документ с этим контрагентом, и сохраняется для следующих периодов:
+Если имя контрагента уже закреплено за другой организацией, система спросит «Имя уже закреплено за другой организацией»
-в новой консолидации те же имена сопоставятся автоматически.
+и предложит «Перенести» псевдоним на выбранную организацию или «Отмена».
 
-## 11. Администрирование: пользователи и роли
+Связь действует на все версии, в которые входит документ с этим контрагентом, и сохраняется для следующих периодов: в
+новой консолидации те же имена сопоставятся автоматически.
+
+## 11. Справочники: группы компаний и организации
+
+«Справочники → ГК и организации» открывает экран «Группы компаний и организаций». Слева — список ГК с поиском «Поиск по
+ГК или CRM ID»; в карточке ГК — название, CRM ID и число организаций. Справа — выбранная ГК: базовый РФ, число
+организаций и вкладки «ЮЛ», «ГСК», «ГСЗ» с количеством.
+
+![Справочник: группы компаний и организации](img/45-catalogue-groups.png)
+
+**Вкладка «ЮЛ»**: «Статус» («Активно» / «Не активно»), «ИНН», «КПП», «Организация», «Тип» (ЮЛ / ИП), «Основной РФ».
+Галочка «Архив» показывает закрытые ЮЛ. Меню «…» в строке: «Изменить ЮЛ», «История изменений» (заглушка «Журнал
+действий»), «Перевести в другую ГК», «Вывести из состава ГК».
+
+**Вкладки «ГСК» и «ГСЗ»**: «ID», «Наименование», «Число участников», «Дата создания». Клик по наименованию открывает
+вкладку «ЮЛ», отфильтрованную по участникам этой группы (плашка «Фильтр по: …» с кнопкой «Сбросить»). Меню строки:
+«Изменить», «Удалить».
+
+![Вкладка «ГСК»](img/46-catalogue-gsk.png)
+
+«Создать ГК/ЮЛ» открывает окно «Выберите объект для добавления»: ГК, ЮЛ, ГСК или ГСЗ.
+
+![Выбор объекта для добавления](img/47-catalogue-create-choice.png)
+
+Формы:
+
+- **ГК** — «Название ГК» (обязательно), «ID ГК в CRM», «Базовый РФ ГК»;
+- **ЮЛ** («Добавить юридическое лицо» / «Изменить юридическое лицо») — «ИНН» (10 цифр для ЮЛ, 12 для ИП), «КПП», «ID ЮЛ
+  в CRM», «Тип», «Наименование организации», «Альтернативные наименования» (введите синоним и нажмите Enter), «Базовый
+  РФ ГК», «ГК», «Входит в ГСК», «Входит в ГСЗ». При изменении ИНН, тип и ГК не редактируются;
+- **ГСК / ГСЗ** — «ID в CRM», «Наименование», «ГК», «Дата создания»;
+- **«Перевести ЮЛ в другую ГК»** — «Новая ГК», «Дата перевода» (не раньше сегодняшней);
+- **«Вывести ЮЛ из состава ГК»** — «Событие» («Закрытие» / «Переход в другую ГК»), «Дата закрытия», «Комментарий».
+
+![Изменение юридического лица](img/48-catalogue-le-form.png)
+
+Альтернативные наименования — те же псевдонимы, что создаются при сопоставлении контрагентов в сводной ОСВ (раздел
+10.3): по ним система узнаёт организацию в ОСВ без ИНН.
+
+После успешного сохранения окно закрывается без уведомления; ошибки показываются внизу справа с заголовком «Ошибка».
+Удалить ГСК или ГСЗ может только администратор. Перед сохранением формы «Изменить юридическое лицо» проверьте поля
+«Входит в ГСК» и «Входит в ГСЗ» — см. «Известные ошибки» в разделе 14.
+
+«Справочники → ЮЛ вне ГК» открывает экран «Юридические лица» — организации, не входящие ни в одну ГК: поиск, та же
+таблица без вкладок, галочка «Архив», кнопка «Создать ЮЛ».
+
+![Юридические лица вне ГК](img/49-catalogue-le-outside.png)
+
+## 12. Администрирование: пользователи и роли
 
 «Система → Пользователи и роли». Раздел доступен пользователю с правом администрирования (на стенде —
 `admin@armka.local`); остальным показывается «Нет доступа».
@@ -422,32 +690,30 @@ PDF с бухгалтерской отчётностью даёт два док
 
 ![Пользователи](img/40-admin-users.png)
 
-«Создать пользователя» → окно «Новый пользователь»: «Email» (обязателен; адреса в домене `.local` отклоняются),
+«Создать пользователя» → окно «Новый пользователь»: «Email» (обязателен; адреса в домене `.local` отклоняются), «ФИО»
-«ФИО» (обязательно), «Табельный номер», «Филиал» (обязателен), «Сегмент», «Роли». Созданный пользователь может войти
+(обязательно), «Табельный номер», «Филиал» (обязателен), «Сегмент», «Роли». После создания появляется уведомление
-сразу.
+«Пользователь \<email\> создан»; созданный пользователь может войти сразу.
 
 ![Новый пользователь](img/41-admin-create-user.png)
 
-Вкладка **«Матрица прав»** — таблица «право × роль» с галочками; роли системные. Изменения накапливаются и
+Вкладка **«Матрица прав»** — таблица «право × роль» с галочками; роли системные. Изменения накапливаются и отправляются
-отправляются кнопкой «Сохранить», «Отменить изменения» возвращает исходное состояние.
+кнопкой «Сохранить» (уведомление «Сохранено ролей: N»), «Отменить изменения» возвращает исходное состояние.
 
 ![Матрица прав](img/42-admin-matrix.png)
 
 Защита последнего администратора: нельзя снять роль ADMIN или право администрирования у единственного администратора и
-нельзя его деактивировать — сервер отвечает ошибкой, роли не меняются.
+нельзя его деактивировать — сервер отвечает ошибкой «Нельзя оставить систему без активного пользователя с правом
+USERS_ADMIN», роли не меняются.
 
-Известный дефект этого экрана в прототипе: уведомления об успехе и ошибке не показываются; результат виден по
+## 13. Статусы и термины
-обновлению таблицы или по ответу сервера во вкладке Network браузера.
-
-## 12. Статусы и термины
 
 **Статус версии консолидации** (бейдж в таблице консолидаций и в шапке сводной ОСВ):
 
 | Статус | Когда |
 |---|---|
 | Инициация | версия создана, документов ещё нет |
-| Обработка документов | есть загруженные файлы, распознавание не завершено |
+| Обработка документов | в консолидацию принят хотя бы один файл |
-| Коррекция данных | документы распознаны, аналитик проверяет и сопоставляет данные |
+| Коррекция данных | есть подтверждённый документ или документ, требующий проверки; аналитик проверяет и сопоставляет данные |
 | Консолидация РФ, Верификация РФ, Консолидация ГО, Верифицирован, Отмена КФО | следующие этапы маршрута; в этой версии недостижимы |
 
 **Статус документа** (панель документов, экраны просмотра):
@@ -455,48 +721,85 @@ PDF с бухгалтерской отчётностью даёт два док
 | Статус | Значение |
 |---|---|
 | Обработка | файл принят, идёт распознавание |
-| Требуется проверка | распознан с замечаниями (шапка другой организации, не определён период, нарушения проверок) — нужна проверка и подтверждение аналитиком |
+| Требуется проверка | распознан с замечаниями (шапка другой организации, не определён период, нарушения проверок, строки без кода) — нужна проверка и подтверждение аналитиком |
 | Загружен | подтверждён (автоматически или вручную), участвует в своде и чек-листе |
 | Ошибка | распознавание не удалось |
-| Отсутствует | в блоке «Организации»: документ этого типа за период не загружен |
 
-**Проверка документа**: «Период» — распознан ли отчётный период и попадает ли в период версии; «Контрагент» —
+В колонках «ОФР» и «Бух.баланс» блока «Организации» и в окне «Чеклист» свои подписи: «Отсутствует» (документ этого типа
-совпадает ли организация из документа с ЮЛ, на которое он загружен.
+за период не загружен), «В обработке», «Распознан», «Требуется проверка», «Загружен», «Ошибка».
+
+**Проверка документа**: «Период» — попадает ли отчётный период документа в период версии (временно не вычисляется,
+всегда «—»); «Контрагент» — совпадает ли организация из документа с ЮЛ, на которое он загружен.
 
 **Тип контрагента**: ГСК — участник группы связанных компаний версии; ГК — другая организация той же группы компаний;
 Внешний — все остальные.
 
+**Строки формы**: строка без кода — код не распознан или его нет в документе; расшифровка — строка «в том числе», в
+суммы формы не входит; подстрока (строка детализации) — часть строки-родителя, показывается под ней с отступом;
+шаблонная строка — достроена по справочнику, пустая.
+
+**Предупреждение** — замечание распознавания: «Информация» (не мешает работе) или «Ошибка» (требует внимания).
+**Автозамена** — замена прежнего файла новым с тем же типом, счётом и периодом (раздел 7.1).
+
 Сокращения: ГК — группа компаний; ГСК — группа связанных компаний; ГСЗ — группа связанных заёмщиков; ЮЛ — юридическое
-лицо (включая ИП); РФ — региональный филиал; ГО — головной офис; ОСВ — оборотно-сальдовая ведомость; ББ —
+лицо (включая ИП); РФ — региональный филиал; ГО — головной офис; ОСВ — оборотно-сальдовая ведомость; ББ — бухгалтерский
-бухгалтерский баланс; ОФР — отчёт о финансовых результатах; КФО — консолидированная финансовая отчётность.
+баланс; ОФР — отчёт о финансовых результатах; КФО — консолидированная финансовая отчётность.
 
-## 13. Ограничения текущей версии
+## 14. Ограничения и известные ошибки
 
-Это особенности прототипа, а не дефекты:
+Особенности прототипа, а не дефекты:
 
-- Нет экранов: справочники ГК/ЮЛ/ГСК, монозаёмщики, Единое хранилище, журнал действий, шахматка, корректировки,
+- Нет экранов: монозаёмщики, Единое хранилище, журнал действий (и «История изменений», которая на него ведёт), шахматка,
-  гудвилл, КФО, смена статусов и маршрут согласования, «Добавить версию», редактирование состава версии, экран
+  корректировки, гудвилл, КФО, смена статусов и маршрут согласования, «Добавить версию», редактирование состава версии,
-  чек-листа (только CSV), комментарии к документам, удаление файлов, правка строк ОСВ.
+  правка строк ОСВ.
+- Комментарий к документу можно добавить, но посмотреть или удалить сохранённые комментарии нельзя.
 - «ГСК» и «Дата верификации» в таблице консолидаций, «Утверждён в РФ» и «Верифицирован в ГО» всегда «—».
-- Таблица консолидаций и статус версии обновляются по F5; блок «Организации» перечитывается при закрытии панели
+- Статус версии обновляется по F5; блок «Организации» перечитывается при закрытии панели документов.
-  документов.
+- Отметка «Период» в колонке «Проверка» временно не вычисляется и всегда «—» — это временное решение; период документа
-- Панель документов показывает первые 100 файлов организации, все периоды вместе; загрузка возможна только из панели
+  сверяйте по колонке «Период».
-  организации внутри выбранной версии.
+- Панель документов показывает первые 100 файлов организации; загрузка возможна только из панели организации внутри
-- Документы типа «Прочий документ» (расшифровки) в панели не открываются.
+  выбранной версии «в работе».
+- Документы типа «Прочий документ» (расшифровки) не открываются — уведомление «Просмотр данного документа недоступен».
 - Фильтр «Счёт» принимает только корень счёта; фильтр «Тип контрагента» — одно значение.
-- Шапку формы (ИНН, дату, единицу измерения) нельзя очистить, только заменить. Время принятия нарушений показывается
+- Шапку формы (организацию, ИНН, дату, единицу измерения) нельзя очистить, только заменить. Время принятия нарушений
-  в часовом поясе браузера, остальные даты — по Москве.
+  показывается в часовом поясе браузера, остальные даты — по Москве.
+- На экранах справочников нет уведомлений об успехе: окно просто закрывается.
 - Распознавание PDF на локальном стенде работает через эмулятор ИС Сканирование: распознаются только PDF из набора
   тестовых данных (`fixtures/ocr`), остальные получают статус «Ошибка».
-- Уведомления в «Пользователи и роли» не появляются (дефект зарегистрирован).
 - Предупреждения в консоли браузера от библиотеки компонентов ни на что не влияют.
 
-## 14. Если что-то пошло не так
+### Известные ошибки
+
+Справочники (исправления запланированы в AURORA-1671 и AURORA-1636):
+
+- **Форма «Изменить юридическое лицо»**: при открытии формы поля «Входит в ГСК» и «Входит в ГСЗ» сбрасываются в «— не
+  указан —», даже если организация в них состоит. Если сохранить форму, не выбрав их заново, организация выйдет из
+  ГСК/ГСЗ. Перед сохранением выберите ГСК и ГСЗ повторно.
+- **Создание ЮЛ, ГСК или ГСЗ из карточки ГК**: поле «ГК» в форме пустое. ЮЛ, сохранённое без выбора ГК, становится
+  организацией вне ГК — выберите ГК вручную.
+- **«Изменить ГСК/ГСЗ»**: пустая «Дата создания» при сохранении заменяется сегодняшней.
+- **Очистка полей**: стереть CRM ID у ГСК/ГСЗ или КПП у ЮЛ в форме изменения нельзя — пустое значение не сохраняется.
+- **Список ЮЛ в карточке ГК** показывает не больше 200 организаций.
+- **Фильтр по ГСК** (плашка «Фильтр по: …») не сбрасывается при выборе другой ГК — у следующей ГК таблица пустая;
+  нажмите «Сбросить».
+- **«ЮЛ вне ГК»**: список может оставаться пустым при открытии из меню сразу после входа или после обновления страницы.
+- **«История изменений»** у ЮЛ открывает журнал действий без фильтра (сейчас это заглушка).
+
+Прочее (задачи пока не заведены):
+
+- **Удаление ГСК/ГСЗ**: пункт «Удалить» виден всем, но сервер разрешает удаление только администратору («недостаточно
+  прав: требуется DIRECTORY_DELETE»).
+- **Проверка формы**: текст отказа по периоду повторяется дважды — «…поправьте дату отчёта. Исправьте дату отчёта в
+  шапке и сохраните.»
+- **Опечатки в интерфейсе**: пункт меню версии «Отключить подвтерждение КФО», заголовок окна «Чеклист» (без дефиса).
+
+## 15. Если что-то пошло не так
 
 - «Сессия истекла» — войдите заново (раздел 2).
-- Файл остаётся в «Обработке» дольше минуты — проверьте, что на стенде запущены сервисы распознавания
+- Файл остаётся в «Обработке» дольше минуты — проверьте, что на стенде запущены сервисы распознавания (`qa-guide.md`,
-  (`qa-guide.md`, раздел 4.2 и 12); панель продолжит опрашивать сервер сама.
+  разделы 4.2 и 12); панель продолжит опрашивать сервер сама.
 - Документ в статусе «Ошибка» — распознавание не удалось; для PDF на локальном стенде это ожидаемо для файлов вне
   тестового набора.
-- Дефект — issue в Gitea: экраны — `RSHB/arm-web`, ответы сервера — `RSHB/arm-core`. Шаблон и как понять, чей баг —
+- Кнопка «Загрузить документы» неактивна — версия не «в работе» (раздел 7.1).
+- Дефект — issue в Gitea: экраны — `RSHB/arm-web`, ответы сервера — `RSHB/arm-core`. Шаблон и как понять, чей баг, —
   `qa-guide.md`, раздел 11. Приложите скриншот экрана и запрос с ответом из вкладки Network.