Доработки модуля ввода данных

Бизнес-требования

Пользователь должен видеть корректную подпись и форматирование строки итогов, без схлопывания текста и с явным словом «Итого»; ввод и отображение должны соответствовать типу данных полей.

При настройке консолидации и сопоставлении полей пользователь может задавать идентификаторы в привычном для данных виде (не только латиница) и при необходимости использовать понятные человеку алиасы.
После удаления строк идентификаторы строк должны оставаться последовательными и предсказуемыми для ссылок, формул и интеграций.
Наличие комментария к ячейке должно быть заметно в интерфейсе без открытия каждой ячейки.
Ограничения видимости столбцов формы, заданные в DIS для пользователя, не должны обходиться при открытии той же формы во Fastboard: пользователь не видит столбцы, которые ему запрещены.
В модальных окнах со длинными списками выбора должен быть быстрый поиск по списку.
В базовом и режиме редактирования доступность элементов настройки и работы с формой должна соответствовать правилам: выражение настраивается только в режиме редактирования; строка итогов доступна всегда; бизнес-процесс виден в режиме редактирования, но не настраивается; консолидация работает в штатном режиме без лишних ограничений.

Решение

Строка итогов

Пользовательский интерфейс

Расположение:

Модуль ввода данных → ПКМ по форме → Добавить/редактировать строку итогов → Модальное окно редактирования строки итогов

Изменения:

Добавить чекбокс "Показывать подпись «Итого» в первом столбце", по умолчанию не выбран
- Если выбран чекбокс "Показывать подпись «Итого» в первом столбце", то для первого столбца в блоке выбора операции агрегирования будет недоступен раскрывающийся список
В раскрывающихся списках для выбора агрегации недоступны варианты, которые не применимы для типа данных столбца: функции СУММ, СРЗНАЧ, ПРОИЗВЕД, МАКС, МИН не работают на столбцах с НЕ числовым типом данных

Системная логика – фронтенд

Если выбран чекбокс "Показывать подпись «Итого» в первом столбце", то блокируется возможность подсчета итогов по этому столбцу, в этом столбце в строке итогов пишется "Итого"+
В раскрывающихся списках для каждого столбца должны быть только те варианты агрегации, которые доступны для указанного типа:
- Для типов "Целое число" и "Дробное число" – все варианты агрегации
- Для остальных типов – варианты агрегации НЕ СЧИТАТЬ, СЧЁТ, СЧЁТЗ

Пересчёт идентификаторов строк при удалении

Системная логика – бэкенд

При выполнении запроса на удаление (table/{tableId}/batch с передачей в теле запроса непустого массива delete) пересчитывать идентификаторы в системном столбце id заново, начиная с 1 по порядку без пропусков и возвращать на фронт

Визуальная индикация комментария к ячейке

Пользовательский интерфейс

Расположение:

Модуль ввода данных → ячейки формы

Изменения:

Ячейка с комментарием отличается от ячейки без комментария: добавляется маркер угла
При наведении на ячейку с маркером комментария доступен просмотр текста комментария.

Системная логика – бэкенд

Возвращать на фронт вместе с данными ячеек метку hasComments логического типа для каждой ячейки формы: True, если есть хотя бы один комментарий, False, если нет ни одного комментария
Возвращать на фронт вместе с меткой комментария список комментов массивом объектов:
- каждый объект включает в себя текст комментария, автора, дату и время создания,
- отдельный массив для каждой ячейки с комментариями

Системная логика – фронтенд

При наличии комментария у ячейки (hasComments = "True") рисовать маркер на углу ячейки
При наведении курсора на ячейку с комментариями показывать во всплывающем окне комментарии списком в формате:
- Блок первого комментария:
  - Автор + дата/время
  - Комментарий
  - Строка отступа
- Блок второго комментария
- и т.д. для всех комментариев
Если комментариев больше 5, то показывать последние 5

Согласованность ограничений видимости столбцов DISМВД и Fastboard (CLS)

Краткоий сценарий:

МВД отдает в FB список в формате: юзер айди в FB: список запрещенных столбцов
Бэк FB создает таблицу-связь между юзерами и источниками-МВД
В этой таблице-связи указываются userId, sourceId, bannedColumns – запрещенные колонки
Фронт запрашивает file_preview от имени юзера. Бэк отдает только те колонки, которых нет в bannedColumns
При ~~насильственном~~ вызове запроса на формирование скрипта с колонкой, которая недоступна пользователю (например, при вызове script/{id}/table/without-save) не пропускать такие запросы с возвратом ошибки
Если есть возможность, контролировать загрузку данных из таких источников: например, устанавливать constraint для столбцов для определенных юзеров

Системная логика – бэкенд МВД

ЗПри получении загпроса PUT table/{tableId}/access/columns на обновление прав доступа к таблице передавать в Fastboard тело зкапроса сх фронта:
- Замемыняя иuser_id дна~~нных~~ user_id в Fastboard
- Добавляя table_id той формы, ~~для~~из ~~Fastboard~~которой пришли измененияе
- Ост ~~те же пр~~авилаяя ~~видимости с~~толбцьков ~~(CLS)~~can_read, игнорируя can_edit

{
  "table_id": "id",
  что[
      {
          "column_name": "string",
          "permissions": [
              {
                  "user_id": "id",
                  "can_read": "boolean"
              }
          ]
      },
      {
          "column_name": "string",
          "permissions": []
      }
  ]
}

Си для DIS, в одном местемная логика – бэкенд Fastboard

Требуется таблица-связь ~~с переис~~пользованите~~м общ~~лей с источниками, необходимо, чтобы в этой таблице было~~гики.~~ поле bannedColumns (запрещенные столбцы)
~~Кэш~~Настроить получени ~~ответы н~~е от МВД запросов на ограничение доступов к столбцам определенных источников, определенных пользователей:
- Если для user_id и table_id приходит column_name с permission.can_read = "False", то в таблицу-связь этого юзера и этой таблицы источника-МВД добавляется значение column_name в bannedColumns

При любых запросах с фронта к этой таблице возвращать только те столбцы, которых нет в bannedColumns (например, в запросе file_preview)

При вызове запроса на формирование скрипта с колонкой, которая недоступна пользователю ~~сод~~(напримерж, прим вызове иscript/{id}/table/without-save) мне пропускать та~~данны~~кие запросы с возвратом ошибки

Если ещёсть возможность, контролировать загрузку данных из таких источников: например, устанавливать constraint для столбцов таблиц для определенных юзеров
- Если такой возможности нет, написать об~~ход~~ этихом прв та~~вил.~~ске

Поиск по спискам в модальных окнах

Проблема: во многих полях ввода есть шеврон для раскрытия списка, но самого списка, по сути, нет – система отдает в формате подсказки возможные варианты

Пользовательский интерфейс

Расположение:

Модуль ввода данных -> модальные окна с длинным списком выбора (конкретный перечень — в подзадаче инвентаризации).

Изменения:

Над списком или в шапке модального окна — поле поиска с фильтрацией по подстроке без учёта регистра (или по правилам продукта).
Пустой поиск показывает полный список; при отсутствии результатов — понятное сообщение.

Системная логика – фронтенд

Реализация поиска для модалок со списком целиком на клиенте: фильтрация уже загруженного списка; при необходимости дебаунс ввода.
Для модалок, где список подгружается с сервера страницами, при доработке API — параметр поиска в запросе списка и согласованное поведение пустой выдачи (оформляется отдельным подпунктом при появлении изменений на бэкенде).

Базовый режим и режим редактирования: доступность элементов

Пользовательский интерфейс

Расположение:

Модуль ввода данных -> панели и меню настроек формы.

Правила доступности:

Выражение: настройка «Выражение» доступна только при включённом режиме редактирования; в базовом режиме скрыта или недоступна.
Строка итогов: работает всегда, вне зависимости от режима (отображение и использование итогов; при отдельном редакторе правил итогирования границы базового режима согласовать с продуктовой политикой, см. примечания).
Бизнес-процесс: в режиме редактирования секция отображается, элементы настройки привязки и параметров недоступны (только просмотр, read-only или disabled).
Консолидация: в обоих режимах без искусственного отключения в базовом режиме, если иное не следует из политики безопасности.

Системная логика – фронтенд

Единые флаги режима редактирования для условного рендера и недоступности (disabled) элементов настройки; единые точки входа для меню и панелей настроек.

Критерии приёмки

В строке итогов отображается слово «Итого» (или локализованный эквивалент); при стандартных размерах окна и колонок текст не сливается в нечитаемую строку; значения итогов соответствуют типам столбцов, при ошибке типа пользователь видит явную обратную связь.
В консолидации при сопоставлении полей допустимы символы, согласованные с бэкендом, без ограничения «только латиница»; алиас задаётся, сохраняется и отображается в интерфейсе настроек и связанных местах.
После удаления строк набор идентификаторов или порядковых номеров согласован с зафиксированной в реализации моделью и не ломает консолидацию, ссылки и повторное открытие формы; отображаемая нумерация без «дыр», если нумерация показывается.
Ячейка с комментарием визуально отличима сразу после добавления комментария и при последующем просмотре таблицы.
Пользователь с запретом на столбцы в DIS не видит эти столбцы во Fastboard при загрузке и дальнейшей работе; для этого пользователя не передаётся содержимое запрещённых столбцов в обход правил CLS.
В согласованном перечне модальных окон модуля ввода данных поиск по списку фильтрует элементы ожидаемо; при отсутствии совпадений отображается понятное состояние пустого списка.
В базовом режиме настройка выражения недоступна; строка итогов отображается и используется; консолидация работает штатно; в режиме редактирования выражение настраивается; бизнес-процесс виден, но не настраивается.

Примечания для постановки в работу

Уточнить у заказчика, относится ли формулировка «строка итогов работает всегда» только к просмотру итогов или также к изменению правил итогирования в базовом режиме — от этого зависит точное правило disabled для редактора итогов.
Для поиска в модальных окнах зафиксировать явный список экранов в подзадаче инвентаризации.
При необходимости запрета обхода настроек через прямой вызов API добавить проверки на бэкенде и тогда дополнить соответствующий подраздел документа разделом «Системная логика – бэкенд».