## Why AURORA-1683 (arm-core #180, эпик AURORA-1353): в AURORA-1445 на экране документа [41] сделано только окно «Добавить комментарий» — список комментариев не запрашивается, добавленный комментарий нигде не виден. В панели «Первичные документы» [39] нет ни иконки комментария, ни счётчика. Причина замены документа пишется комментарием к заменяемому документу (`FilesDrawer`), и её тоже негде прочитать. API ядра готов с 07.10.2026 (spec `documents-api`, требование «Комментарии к документу»): `GET`/`POST /documents/{id}/comments`, `comments_count` в карточке файла и документа. ## What Changes Репозиторий — только arm-core (`web/`); эндпоинты, бэкенд и DBML без изменений. Срез 2c (документы), правки фронта по замечаниям спринта 3. - Экран документа [41]: кнопка «Добавить комментарий» заменяется кнопкой «Комментарии (N)» (`N = comments_count` документа). Она открывает боковую панель «Комментарии к документу»: список (автор, дата и время по Москве, текст) по возрастанию времени и поле ввода с кнопкой «Добавить». После добавления список и счётчик обновляются. - Панель «Первичные документы» [39]: в строке документа — кнопка с иконкой комментария и числом комментариев (при нуле — только иконка), как в макете [39-01]. По клику — поповер «Комментарии к документу <файл>» со списком только для чтения; без комментариев — «Комментарий отсутствует», кнопка «Закрыть». - Окно `CommentModal` удаляется — добавление переезжает в боковую панель экрана документа. - Дельты: `document-review-ui` — ADDED «Комментарии к документу»; `primary-files-ui` — ADDED «Комментарии документа в панели». Таблицы DBML v5.23 (только чтение через API): `comment` (`object_type = 'document'`), `app_user` (ФИО автора). ## Non-goals - Правка и удаление комментариев — их нет в API и не будет (spec `documents-api`). - Добавление комментария из панели «Первичные документы» — в поповере только чтение. - Проверка права `DOCUMENT_EDIT` на фронте: кнопку «Добавить» не прячем, отказ сервера (403) показывается сообщением, как сейчас в `CommentModal`. - Комментарии к строкам и ячейкам формы, к консолидации — отдельные сущности, не этот change. - Изменения бэкенда и DBML. ## Capabilities ### New Capabilities ### Modified Capabilities - `document-review-ui`: ADDED требование «Комментарии к документу». - `primary-files-ui`: ADDED требование «Комментарии документа в панели». ## Impact - `web/src/types/api.ts` — тип `CommentOut`. - `web/src/services/api/documents.ts` — `getComments`. - `web/src/utils/dates.ts` — `formatMoscowDateTime` (+ тест). - `web/src/widgets/FilesDrawer/documentRows.ts` — `commentsCount` в строке (+ тест). - `web/src/widgets/DocumentComments/` — общий список комментариев, боковая панель экрана документа, поповер панели. - `web/src/layouts/DocumentPage.tsx`, `web/src/widgets/FilesDrawer/FilesList.tsx`; удаляется `web/src/widgets/DocumentReview/CommentModal.tsx`. - Тестов компонентов в `web/` нет (vitest — только чистые функции); экраны сверяются с макетом [39-01], [41] в браузере.