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

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

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

Решение

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

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

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

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

Изменения:

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

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

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

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

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

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

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

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

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

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

Изменения:

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

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

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

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

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

Согласованность ограничений видимости столбцов МВД и 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 той формы, из которой пришли изменения
- Оставляя только can_read, игнорируя can_edit

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

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

Требуется таблица-связь пользователей с источниками, необходимо, чтобы в этой таблице было поле bannedColumns (запрещенные столбцы)
Настроить получение от МВД запросов на ограничение доступов к столбцам определенных источников, определенных пользователей:
- Если для user_id и table_id приходит column_name с permission.can_read = "False", то в таблицу-связь этого юзера и этой таблицы источника-МВД добавляется значение column_name в bannedColumns
При любых запросах с фронта к этой таблице возвращать только те столбцы, которых нет в bannedColumns (например, в запросе file_preview)
При вызове запроса на формирование скрипта с колонкой, которая недоступна пользователю (например, при вызове script/{id}/table/without-save) не пропускать такие запросы с возвратом ошибки
Если есть возможность, контролировать загрузку данных из таких источников: например, устанавливать constraint для столбцов таблиц для определенных юзеров
- Если такой возможности нет, написать об этом в таске

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

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

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

Расположение полей без списков:

МВД → ПКМ по ячейке таблицы →
- Настроить выражение → Добавить правило → Целевая колонка
- Консолидация → Добавить источник →
  - Таблица источник
  - Добавить сопоставление ключей →
    - Исходный ключ
    - Ключевая колонка текущей таблицы
  - Добавить сопоставление значений →
    - Исходное значение
    - Колонка текущей таблицы

Расположение списков с лишним значением:

МВД → ПКМ по ячейке таблицы → Настроить бизнес-процесс → Включить →
- Начальный статус
- Переходы между статусами →
  - Из статуса
  - В статус
Фильтры → Выберите колонку

Изменения:

Для полей без списков – заменить на раскрывающиеся списки
Для списков с лишними значениями – убрать дефолтное значение из списка, по умолчанию подставляется первое значение из набора данных

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

Реализовать в указанных в пользовательском интерфейсе местах раскрывающиеся списки
Во всех списках по умолчанию стоит первое из доступных значений
Свободный ввод (как в поле ввода) запрещён
Подтягивать в эти списки значения:
- В целевую колонку бизнес-правил – все колонки открытой таблицы
- В таблицу-источник в консолидации – все таблицы всех доступных проектов, первыми в списке идут таблицы текущего проекта, если имеются (кроме той таблицы, из которой вызвана консолидация)
- В исходный ключи и исходное значение консолидации:
  - При наличии выбранной таблицы-источника – поля выбранной таблицы-источника
  - При отсутствии выбранной таблицы-источника – ничего
- В ключевую колонку текущей таблицы и колонку текущей таблицы консолидации – поля из текущей таблицы
Удалить первое значение в указанных в пользовательском интерфейсе раскрывающихся списках

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

Возвращать в ответ на запрос search не только проекты и таблицы, но и столбцы всех этих таблиц

Режим редактирования

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

Контекстное меню ячейки в режиме редактирования (с максимальным уровнем прав):

Консолидация
Настроить выражение
Массовая операция по подмножеству
Добавить строку итогов
———————————
Добавить строку ниже
Добавить строку выше
Удалить строку

Контекстное меню ячейки в базовом режиме (с максимальным уровнем прав):

Режим редактирования
Редактировать форму
Настроить права доступа
———————————
Консолидация
Настроить бизнес-процесс
Добавить строку итогов
Показать ID
———————————
Импорт из Excel
Экспорт в Excel
———————————
Комментарий ячейки
История ячейки

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

Перегруппировать контекстные меню (см. порядок в пользовательском интерфейсе)
Добавить разделители в контекстные меню (см. порядок в пользовательском интерфейсе)
Изменить доступность кнопок:
- Настроить выражение: настройка доступна только при включённом режиме редактирования; в базовом режиме недоступна.
- Массовая операция по подмножеству: только в режиме редактирования
- Строка итогов: работает всегда, вне зависимости от режима.
- Настроить бизнес-процесс: в режиме редактирования отображается только интерфейсная часть текущего процесса, элементы настройки привязки и параметров недоступны
- Настроить права доступа: только в базовом режиме
- Консолидация: работает всегда, вне зависимости от режима.

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

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

Открыть модальное окно добавления или редактирования строки итогов (ПКМ по форме → Добавить/редактировать строку итогов) – отображается чекбокс «Показывать подпись «Итого» в первом столбце», по умолчанию не выбран.

Включить чекбокс, сохранить настройки и открыть форму – в строке итогов ~~отоб~~в пер~~ажается сло~~во «Итого» (или локализованный эквивалент); при стандартных размерах окна и колонок текст не сливается в нечитаемую строку; значения итогов соответствуют типам столбц~~ов, при ошибк~~е ~~типа пользователь видит явную обратную связь.~~

В консолидации при сопоставлении полей допустимы символы, согласованные с бэкендом, без ограничения «только латиница»; алиас задаётся, сохраняется и отображается «Итого»; при повторном открытии модальнтого окна для перфвого столбца список операцийс агрегирования наедостроупе~~к и связа~~н~~ных местах~~.
ПОткрыть списоск агрегации дл~~е удалени~~я столбца типа «Целое число» или «Дробное число» – в списке доступны все операции, включая СУММ, СРЗНАЧ, ПРОИЗВЕД, МАКС, МИН.

Открыть список агрегации для столбца с любым другим типом – доступнабы только НЕ СЧИТАТЬ, СЧЁТ, СЧЁТЗ; СУММ, СРЗНАЧ, ПРОИЗВЕД, МАКС, МИН отсутствуют или недоступны.

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

Включить «По~~ряд~~к~~овых~~азать ~~номеров согласован с~~ID», зафиксированть ноймера в рстолбце~~ализации~~ ~~моделью~~id и– н~~е л~~омера~~ет консолидацию, ссылки и повторное открытие формы;~~ отображаются.

Удалить одну или немсколько строк из середины таблицы – в столбце id остаётся непрерывная нумерация с 1 без ~~«ды~~пр»,опусков; оставшиесля строки редактируются и сохраняются без ошибок.

Визу~~мер~~альная индикация ~~показывается.~~

~~Ячейка с~~ комментария к ячейке:

Добавить комментарий к ячейке и сохранить – у ячейки появляется маркер виз уагльну.

Про смотреть табли~~чима сраз~~цу после добавления комментариев в разные ячейки – ячейки с комментариями отличаются маркером, ячейки без комментариев – без маркера.

Навести курсор на ячейку с одним или несколькими комментариями – во всплывающем окне для каждого комментария отображаются автор, дата и время, текст.

Добавить в одну ячейку более пяти комментариев, навести курсор – во всплывающем окне отображаются пять послед~~ующ~~них коммемнтариев пс авторосм, дато~~тре~~й и т~~аблицы~~екстом.
П

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

В МВД загпр~~узк~~етить ~~и дальнейшей рабо~~те~~; для э~~стогвому пользователяю чтение одного или нескольких столбцов формы – переда~~ётся~~ва сохранены.

Открыть ту же форму во Fastboard под~~ерж~~ этим пользователем – запрещённых столбцов ~~в обход правил CLS.~~

~~В согласова~~н~~ном перечне модальных окон модуля ввода данных поиск по списку фильтру~~ет эв таблице~~менты~~ ожи~~даемо;~~ при предпросмотре.

Под пользователем су запретом выполнить действиие с недоступным столбцом (например формировпаденийе скрипта) – операция не выполняется, отображается понятная ошибка.

Открыть форму во Fastboard под пользователем с полным доступом – отображаются все столбцы формы.

Раскрывающиеся списки в модальных окнах и полях настройки:

Открыть настройку выражения, консолидации, бизнес-процесса или фильтр в перечисленных в ТЗ полях – вместо свободного ввода отображается раскрывающийся список, произвольный текст ввести нельзя.

Открыть любое из этих окон без предварительного выбора – в каждом списке по умолчанию выбрано первое доступнояе значение, пустая строка не подставлена.

Открыть «Целевую колонку» в правиле выражения – в списке только колонки открытой таблицы.

Открыть «Таблицу-источник» в консолидации – в списке таблицы доступных проектов, таблицы текущего проекта в начале; таблица, из которой открыта консолидация, отсутствует.

Открыть консолидацию без выбранной таблицы-источника – списки «Исходный ключ» и «Исходное значение» пусты; выбрать таблицу-источник – в списках появляются поля выбранной таблицы.

Открыть настройку бизнес-процесса или фильтр – в списках «Начальный статус», «Из статуса», «В статус», «Выберите колонку» нет пустого значения по умолчанию, сразу доступны реальные статусы или колонки.

Режим редактирования:

Открыть контекстное меню ячейки в базовом режиме (максимальный уровень прав) – порядок пунктов и разделители соответствуют ТЗ; пунктов «Настроить выражение» и «Массовая операция по подмножеству» нет.

Включить режим редактирования, открыть контекстное меню – порядок пунктов и разделители соответствуют ТЗ; пункта «Настроить права доступа» нет.
В базовом режиме ~~настройка~~ вырзва~~жен~~ть «Добави~~я недос~~т~~упна;~~ь строкау итогов ~~отображается~~» и ~~используется; к~~«Консолидация» – окна открываются; повторить в режиме редабктирования – окна также открываются.

В режиме редактирования вызвать «Настроить выражение» и «Массовая операция по подмножеству» – функции доступны; в базовом режиме эти пункты в меню отсутствуют или недоступны.

В базовом режиме вызвать «Настроить права доступа» – окно открывает ~~штатно~~ся; в режиме редактирования пункта в~~ыраж~~ меню нет.

В режиме редактирования открыть «Настраои~~вае~~т~~ся;~~ь бизнес-процесс» – текущий процесс на форме виден, элемен~~о не~~ты настраойки привязки и параметров недоступны для изменения.