Найти в Дзене

Создание ТЗ для приложений ТОиР

Приветствую, джентльмены!
Если вам, как и мне, очень нравятся замечательные системы SAP ТОРО или 1С ТОиР, то вы точно знаете, о чем я буду говорить дальше.
Мощные платформы, с большим количество функционала..., но увы и ах, не всегда дружелюбные к пользователю и адаптивные к нашим потребностям. И вот, появляется мечта - создать удобное, интуитивно понятное веб-приложение для планирования ТОиР, которое должно как-то работать с этим монстром. Задача не из легких, но выполнима! Секрет успеха - грамотное детальное ТЗ на разработку, которое не просто описывает желаемый функционал, но четко определяет, как выше новое веб-приложение будет взаимодействовать с SAP или 1С.
Сегодня поделюсь своим опытом и лайфаками, как составить такое ТЗ, чтобы разработчик не просто поняли, что вы хотите, а еще и сказали спасибо за четкость и системность. Как в любом ТЗ, макеты экранов - это наше все. Нужно четко показать, какие данные будут отображаться, откуда они будут мигрировать из SAP/1C, и как пользов
Оглавление

Приветствую, джентльмены!
Если вам, как и мне, очень нравятся замечательные системы SAP ТОРО или 1С ТОиР, то вы точно знаете, о чем я буду говорить дальше.
Мощные платформы, с большим количество функционала..., но увы и ах, не всегда дружелюбные к пользователю и адаптивные к нашим потребностям.

И вот, появляется мечта - создать удобное, интуитивно понятное веб-приложение для планирования ТОиР, которое должно как-то работать с этим монстром. Задача не из легких, но выполнима! Секрет успеха - грамотное детальное ТЗ на разработку, которое не просто описывает желаемый функционал, но четко определяет, как выше новое веб-приложение будет взаимодействовать с SAP или 1С.

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

Макеты для экранов - рисуем, что хотим

Как в любом ТЗ, макеты экранов - это наше все. Нужно четко показать, какие данные будут отображаться, откуда они будут мигрировать из SAP/1C, и как пользователь будет взаимодействовать с ними.

Чем пользоваться:
Вам надо показать, что вы хотите, есть профессиональные инструменты макетирования - Figma, Adobe XD, Sketch, НО смысл показать ваш минимальный набор визуала, поэтому даже если у вас под рукой есть только Power Point, вы можете в нем сделать неплохой макет из набора стандартных прямоугольников, линий....

Обязательно после предполагаемой картинки макета, необходимо указывать требования к нему:

Источник данных:
Четко укажите, из какой таблицы и поля SAP/1C берется тот или иной элемент данных. Например, заводской номер оборудования из таблицы EQUZ, поле SERNR.

Формат данных:
Укажите формат данных который будет отображаться на экране, например "хх-yyy"

Возможность редактирования:
Если пользователь должен иметь возможность редактирования данных, укажите, как эти изменения будут передаваться обратно в SAP/1C. Например статус "Запланировано" в веб-приложении соответствует статусу "CRTD" в SAP.

Пример - Экран планирования ремонта плунжерного насоса

Наш любимый плунжерный насос. Представим экран планирования с SAP ТОРО:

Фильтр:

Поле “Цех” – выбор из списка, данные подтягиваются из SAP (таблица T001W, поле WERKS).

Поле “Участок” – выбор из списка, данные подтягиваются из SAP (таблица IWERK, поле ABTEI).

Поле “Модель насоса” – выбор из списка, данные подтягиваются из SAP (таблица EQUZ, поле EQKTX).

Таблица:

“Насос” (Модель, серийный номер) – данные из SAP (таблица EQUZ, поля EQKTX и SERNR).

“Тип ремонта” – данные из SAP (таблица ILOA, поле ARTPL). Отображается расшифровка кода типа ремонта.

“Дата начала” – данные из SAP (таблица AUFK, поле GSTRP).

“Дата окончания” – данные из SAP (таблица AUFK, поле GLTRP).

“Ответственный” – данные из SAP (таблица AUFK, поле AEDAT). Отображается ФИО сотрудника, а не только ID.

“Статус” – данные из SAP (таблица JEST, поле STAT). Отображается текстовое описание статуса, а не только код.

Описание функционала:

При нажатии кнопки "Добавить ремонт", происходит автоматическое создание заказа в SAP, веб-приложение открывает форму, в которой заполняются необходимые поля для создания заказа SAP. После сохранения, создается новый заказ в SAP, и его номер отображается на соответствующем поле на экране.

Описание интеграции:

Необходим максимально подробно описать, как происходит взаимодействие между веб-приложением и SAP/1C.

Типы интеграции:

Чтение данных из SAP/1С - Как часто происходит синхронизация данных? Какие данные необходимо читать?

Запись данных в SAP/1С - Какие данные можно изменять в веб-приложении, и как эти изменения передаются в SAP/1С?

Триггеры - Какие события в SAP/1С должны инициировать действия в веб-приложении, и наоборот? (Например, при создании нового заказа в SAP, в веб-приложении должно появиться уведомление).

Протоколы обмена данными:

Какие протоколы будут использоваться для обмена данными между веб-приложением и SAP/1С?

Какие форматы данных будут использоваться?

Обработка ошибок:

Как будет обрабатываться ситуация, когда данные не удалось получить из SAP/1С?

Как будет обрабатываться ситуация, когда не удалось записать данные в SAP/1С?

Какие сообщения об ошибках будут отображаться пользователю?

Как будут логироваться ошибки?

Не упускаем мелочи, особенно критичные для интеграции

Авторизация и аутентификация:

Как пользователи будут авторизовываться в веб-приложении? Будет ли использоваться аутентификация SAP/1С?

Обработка больших объемов данных - Как приложение будет обрабатывать большие объемы данных из SAP/1С? Будет ли использоваться постраничная загрузка?

Соответствие нормативным требованиям:

Убедитесь, что взаимодействие с SAP/1С соответствует требованиям по безопасности и защите данных.

Тестирование:

Предусмотрите тщательное тестирование интеграции, чтобы убедиться, что все работает корректно.

Помните о целях!

Ваша главная цель - создать удобное приложение для планирования ТОиР. Не позволяйте сложностям интеграции отвлекать от этой цели.

Пример экрана веб-приложения планирования ТОиР

Создать удобное веб-приложение для планирования ТОиР с интеграцией с SAP/1C - это вполне реально. Главное - составить детальное, понятное ТЗ, в котором четко описаны детали интеграции и учтены особенности обмена данными. Помните, что четкость и системность - ваши лучшие друзья!

----

Если возникли вопросы и есть желание сотрудничества, пишите asgoldobin@yandex.ru

Будем на связи 🤝 Standby mode!