54 lines
4.5 KiB
Markdown
54 lines
4.5 KiB
Markdown
## 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] в браузере.
|