arm-core/openspec/changes/archive/2026-10-27-document-comments-ui/proposal.md

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] в браузере.