2026-11-09 — Редактирование комментария к заказу вне задачи
Статус: Реализовано
Источник: Олег
Эпик: ITR-3471
Связанные материалы: orders.md (§ «Комментарий к заказу покупателя»), clickable-https-links.md.
Цель
Дать ответственному менеджеру по продажам и его помощникам править комментарий к заказу покупателя в любой момент — не только когда на них висит editable-задача процесса.
Правка — с карточки заказа и с левой вкладки «Просмотр заказа» в задачах; сохранение сразу, без сохранения всей формы задачи.
Контекст
Как сейчас (после реализации)
- Ответственный менеджер по продажам и его помощники (по связям «помощник → менеджер») видят у комментария на карточке / во вкладке просмотра заказа иконку карандаша.
- По нажатию открывается окно как у «Развернуть», с редактируемым текстом и кнопкой «Сохранить».
- После сохранения комментарий на карточке / вкладке обновляется сразу.
- Редактирование комментария через форму задачи (когда задача уже editable) осталось как раньше — этот эпик его не меняет и не дублирует карандашом на основных формах задач.
- Право не зависит от того, есть ли сейчас задача на сотруднике, и не блокируется завершением процесса по заказу.
Пользовательские сценарии
- Правка с карточки. Ответственный менеджер открывает заказ покупателя, нажимает карандаш у «Комментарий», правит текст, сохраняет. Комментарий обновлён; задачу процесса открывать не нужно.
- Правка из задачи через вкладку. Помощник ответственного менеджера в карточке задачи открывает левую вкладку «Просмотр заказа», правит комментарий карандашом и сохраняет. Основная форма задачи и её черновик не обязаны подхватывать новый текст в этом эпике.
- Нет права. Сотрудник без роли ответственного / помощника по этому заказу (в т.ч. только начальник продаж или только Admin) карандаша не видит; попытка сохранить через API отклоняется.
- Очистка. Ответственный или помощник может сохранить пустой комментарий.
- Как раньше через задачу. На этапе, где комментарий уже редактируется в форме задачи, поведение сохранения задачи не меняется.
Принятые решения
| Тема | Решение |
|---|---|
| Кто правит «в любой момент» | Только ответственный менеджер по продажам и его помощники |
| Начальник продаж / Admin / сопровождающий | Без этого права (если только эта роль) |
| Где UI | Карточка заказа + левая вкладка «Просмотр заказа» в задачах |
| Основные формы задач (поле «Комментарий» на КП, спецификации и т.д.) | Вне scope этого эпика |
| Привязка к задаче / editable | Не требуется |
| Завершённый процесс / статус заказа | Не блокируем правку комментария |
| Очистка комментария | Разрешена |
| Как понять на UI, что можно править | Признак с сервера при отдаче заказа (фронт сам связи менеджеров не вычисляет) |
| UX | Карандаш → модалка как «Развернуть» + Сохранить |
| Сохранение | Отдельный запрос, не Save всей задачи |
Схема
Карточка заказа / вкладка «Просмотр заказа»
→ комментарий (просмотр) + «Развернуть»
→ если есть право: карандаш
→ модалка (текст) → Сохранить → комментарий обновлён
Формы задач (КП, спецификация, …)
→ как сейчас: правка комментария только в editable-задаче
Критерии приёмки
- Ответственный менеджер по продажам видит карандаш у комментария на карточке заказа и может сохранить новый текст.
- Помощник этого менеджера — то же на карточке и на левой вкладке «Просмотр заказа» в задаче.
- Сотрудник без права карандаша не видит; сохранение без права отклоняется.
- Начальник продаж и Admin без роли ответственного / помощника по заказу карандаша не получают.
- Сохранение не требует открытой editable-задачи и не блокируется завершённым процессом.
- Пустой комментарий сохранить можно.
- На основных формах задач поведение комментария не изменилось (эпик их не трогает).
- После сохранения на карточке / вкладке отображается актуальный текст (в т.ч. кликабельные
https://…в режиме просмотра — как сейчас).
Вне scope
- Карандаш / отдельное сохранение комментария на основных формах задач (КП, спецификация, расчёт суммы и т.д.).
- Право править комментарий для начальника продаж, Admin, сопровождающего «просто так».
- Обязательная синхронизация текста комментария в открытый черновик формы задачи после правки с вкладки.
- История изменений комментария, уведомления о правке, rich text.
Задачи эпика
| # | Задача | Смысл | Статус |
|---|---|---|---|
| 1 | Задача 1. Бек. API правки комментария и признак права | Отдельное сохранение комментария; проверка «ответственный SM или его помощник»; признак права в ответе по заказу | Сделано |
| 2 | Задача 2. Фронт. Карандаш и модалка на просмотре заказа | Карандаш на карточке и вкладке «Просмотр заказа»; модалка с Сохранить; только при признаке права | Сделано |
| 3 | Задача 3. Документация. User docs по комментарию заказа | Кто и откуда может править комментарий вне задачи | Сделано |