Проверки координации необходимы для обеспечения совместной работы. Они отслеживают взаимосвязи моделей разных дисциплин друг с другом, исключают ошибки при работе со связями и ускоряют совместную работу.
Обеспечивает непрерывность проектирования и отслеживает изменения модели по всем разделам проектной документации
При нормативных трудозатратах на проверку моделей в 3% - 5% использование BIM Inspector позволяет сократить эти затраты в несколько раз. Текущие затраты на проверку моделей не превышают 1%
Выпущенные модели, при наличии отклонений, требуют дополнительного согласования BIM координаторами и руководителями дирекций. Согласование реализовано в BIM Inspector Configurator, где выбирается нужный файл и по итогам проверки модели выполняется согласование. После прохождения цепочки согласования модель доступна к выгрузке. Согласование отклонений позволяет избежать торможение процесса проектирования в форc-мажорной ситуации.
Новые проверки создаются в соответствии с описанной последовательностью действий
Определить внешнего заказчика
Выявить экономическую эффективность от внедрения разработки
Обсудить возможность реализации разработки с командой разработки
Назначить координатора задачи со стороны заказчика
Составить техническое задание на разработку
Создать задачу в проекте Asana в колонке "ЗАДАЧИ (TODO)", создается связь с историей, созданной под каждого заказчика, и назначить исполнителем руководителя проекта.
Все новые разработки фиксируются в проекте "BIM Inspector" Jira
НУЖНО СДЕЛАТЬ (TODO) - в данной колонке bim - координаторами фиксируются задачи, которые по их мнению необходимо автоматизировать.
НА РАССМОТРЕНИИ - задачи с готовым ТЗ от bim - координатора. ТЗ проходят проверку РП и тимлидом и по необходимости дорабатываются. По итогу рассмотрения заполняется чек лист полноты исходных данных.
ОЦЕНКА - задачи прошедшие рассмотрение и имеющие полный комплект исходных данных, подтвержденный чек листом попадают на оценку. Оценка задачи ставится в план следующего спринта при наличии заполненного чек листа. Происходит оценка трудозатрат на разработку РП и тимлидом продукта. Определяется ответственный разработчик.
ГОТОВ К РАЗРАБОТКЕ - задачи с имеющейся оценкой ставятся в план разработки. План разработки формируется на 1 месяц вперед с точностью "день". План разработки на квартал составляется с точностью "месяц". План разработки на год составляется с точностью "квартал".
В РАБОТЕ - задачи в статусе разработки находятся в работе в текущем спринте. Разработка ведется 2-х недельными спринтами. Если реализация задачи занимает более 2-х недель, то она разбивается на более мелкие задачи, а при невозможности ставится в план того спринта в котором планируется завершение и работа над задачей берется с даты.
РЕВЬЮ- задачи на проверке кода.
Тестирование и документирование выполняется параллельно в течении 2-х недель. Во время тестирования выполняется отработка замечаний по результатам тестирования. При успешном завершении тестирования и при наличии инструкции задача переходит в состояние "Готов к релизу". В четверг перед релизом
ТЕСТИРОВАНИЕ - задачи в статусе внутреннего тестирования продукта.
BIM ТЕСТИРОВАНИЕ - задачи на тестировании BIM координаторами, выполняется параллельно внутреннему тестированию, но не может перейти в следующий статус до завершения этапа.
ДОКУМЕНТИРОВАНИЕ - задачи по которым готовится документация в виде инструкций по готовому продукту, параллельно разработке и тестированию, но не может перейти в следующий статус до завершения этапа.
ГОТОВО К РЕЛИЗУ - задачи
РЕЛИЗ (DONE) - задачи, по которым разработка завершена и они готовятся к релизу. Задачи в статусе завершенной разработки, готовой к релизу. Релиз проводится по понедельникам с 19:00 до 10:00 следующего дня по МСК, при наличии успешного завершения тестирования задач, входящих в релиз.
При создании задачи необходимо:
Указать наименование задачи, которое обозначает действие в форме глагола совершенного вида (Например: Разработать проверку "Квартирография") и поместить задачу в колонку "ЗАДАЧИ (TODO)", исполнителем назначить руководителя продукта
Указать тип разработки:
Разработка - новая разработка
Доработка - добавление функционала, либо частичное изменение старого. (Повышение минорной версии. 1.0 -> 1.1)
Исправление - внесение изменений отвечающих за стабильность, исправление ошибок (Повышение версии сборки 1.0 -> 1.0.1)
Указать "Проект/Продукт" разработки:
[ADV] Выполнить план развития продукта "BIM Inspector": РАЗВИТИЕ
[BIM] Блок проверок BIM модели БКП/СКБ для выгрузки в BDS
[AR] Блок проверок BIM модели АР
[KR] Блок проверок BIM модели КР
[IOS] Блок проверок BIM модели ИОС
[CIVIL] Блок проверок Civil
Приложить Ссылку на ТЗ
Установить Приоритет:
Если задача срочная. Без нее нельзя продолжать работу - Приоритет выставить Неотложная/Серьезная/Критическая
Если задача плановая - установить приоритет Обычная
Если на задачу нет внешнего заказчика - установить приоритет Незначительная
Все файлы с ТЗ необходимо сохранять в соответствующую папку на общем Google-диске.
Шаблон ТЗ Папка с ТЗ BIM Inspector
Необходимо создать блок-схему проверки/плагина в MIRO.
Если у инспекции есть общая часть схемы с другим инструментом (ex: PIK Tools), в блок схеме общую часть необходимо выделить рамкой зеленого цвета. Необходимо дать название данной рамке "SDK PIKTools с Именование инструмента". К рамке необходимо приложить ссылку на общую часть в доске MIRO другого инструмента, отметить @ руководителя продукта.
Проверить у каких инструментов есть общая часть с другими продуктами (ex: PIK Tools) можно в таблице.
Альтернативные ПО для разработки блок-схем не допускаются.
В рамках составления ТЗ необходимо подготовить тестовый файл. Требования к тестовому файлу:
Файл для тестирования необходимо размещать на тестовом сервере в соответствующую папку
\\vpp-revit19_bim.main.picompany.ru\D$\RS19\Projects\0000_BIMInspector\Корпус\30_АР
\\vpp-revit19_bim.main.picompany.ru\D$\RS19\Projects\0000_BIMInspector\Корпус\40_КР
\\vpp-revit19_bim.main.picompany.ru\D$\RS19\Projects\0000_BIMInspector\Корпус\51_ЭОМ
\\vpp-revit19_bim.main.picompany.ru\D$\RS19\Projects\0000_BIMInspector\Корпус\52_ВК
\\vpp-revit19_bim.main.picompany.ru\D$\RS19\Projects\0000_BIMInspector\Корпус\53_ОВ
\\vpp-revit19_bim.main.picompany.ru\D$\RS19\Projects\0000_BIMInspector\Корпус\55_СС
Файл для тестирования необходимо отсоединять от модели хранилища с сохранением рабочих наборов, с настройкой “Задать” при открытии;
Файл необходимо пересохранить как новый файл хранилища с указанием “Тестовый” в наименовании файла;
Файл для тестирования необходимо очистить от следующих категорий (если функционал проверки с ними не связан*):
1) Неиспользуемые элементы модели. (Управление - Удалить неиспользуемые”);
2) Импортированные категории CAD;
3) Внешние ссылки на файлы САПР;
4) Внешние ссылки на файлы .rvt;
*Если функционал проверки связан с внешними ссылками, необходимо приложить связанные файлы вместе с основным тестовым файлом и обновить пути к связям. (“Диспетчер связей”-”Обновить из”);
Файл для тестирования должен содержать вид для тестирования, его необходимо выбирать в качестве начального вида. (Управление - Управление проектом - Начальный вид);
Файл для тестирования должен содержать все элементы/виды/семейства, необходимые для проведения тестов и включать:
корректные элементы;
элементы по каждой из ошибок;
элементы по каждому из предупреждений;
В задание на разработку содержится таблица с реакцией сервиса на обрабатываемые события, включающая описание события и реакция в виде выводимых сообщений или ошибок:
В ТЗ необходимо добавить таблицу, в которую включить по каждому шагу проверки ID элементов с успешным и ошибочным результатом выполнения данного шага:
После подготовки ТЗ руководителем продукта "BIM Inspector" выполняется проверка полноты исходных данных и заполняется чек лист .
При наличии полного комплекта исходных данных, задача берется на оценку в следующем спринте. Оцененная задача переносится в колонку "Готов к разработке".
Задачи с имеющейся оценкой ставятся в план разработки. План разработки формируется на 1 месяц вперед с точностью "день". По задаче с планом "месяц" заполняются данные о сроках в полях "Target start" и "Target end", а так же "Дата тестовой сборки". Где "Target start" - дата начала разработки, "Target end" - дата окончания разработки, "Дата тестовой сборки" - дата выкладки задачи на тестовый сервер. План разработки на квартал составляется с точностью "месяц". План разработки на год составляется с точностью "квартал".
Перед тестированием новой сборки необходимо удалить старую тестовую сборку через "Пуск - Приложения" - "Удаление программ"
Пошаговая инструкция по тестированию:
1) В проекте Asana перейти в колонку "Тестирование" и открыть задачу по разрабатываемой версии "Обновление BIM Inspector XX.X.X.X";
2) Закрыть Revit/Civil3D/AutoCAD (в зависимости от целевого ПО клиента );
3) Варианты тестирования:
Тестирование плагина / проверки (Тип1/Тип2);
Тестирование проверки;
Тестирование сайта
4) Установка и запуск тестирования:
Тестирование плагина / проверки (Тип1);
- Скачать и установить тестовую сборку, используя "PIKTool BOX";
- Запустить Ревит;
- Включить BIM Inspector стандартным способом (ПИК - Общие - BIM Inspector);
- Перевести плагин в режим тестирования, нажав комбинацию клавиш [leftCTRL]+[leftALT]+[U];
- Выбрать сервер: Тестовый / Разработка / Продуктовый
Тестирование плагина / проверки (Тип 2);
- Скачать и установить сборку .msi или .exe дистрибутива плагина;
- Запустить Ревит;
- Включить BIM Inspector стандартным способом (ПИК - Общие - BIM Inspector);
- Перевести плагин в режим тестирования, нажав комбинацию клавиш [leftCTRL]+[leftALT]+[U];
- Выбрать сервер: Тестовый / Разработка / Продуктовый
Тестирование сайта "BIM Inspector".
- Перейти на сайт;
- Развернуто три среды для сайта:
Разработка: https://bi2.bimteam.ru
Тестирование: https://bi1.bimteam.ru
Эксплуатация: https://bi.bimteam.ru
- Зайти на сайт тестовой среды https://bi1.bimteam.ru;
7) Можно начинать тестировать продукт. Перечень требований и рекомендаций для упрощения процесса тестирования готового продукта:
Общее тестирование:
- Выполнить проверку по методологии с занесением результатов в таблицу;
Установка
Запуск программы Revit 2019
Включение/отключение плагина кнопкой “BIM Inspector” с отображением панели
Открытие тестового проекта
Полная проверка модели кнопкой “Запустить проверку”
Дисциплина АР (RSN://vpp-revit19_BIM.main.picompany.ru/9999_Площадка/Корпус 01/30_АР/9999-Р-ЖД-01-АР-общий_BIM 19.2Р.rvt)
Дисциплина КР (RSN://vpp-revit19_12.main.picompany.ru/9999_Отдел внедрения BIM/Корпус 01/40_КР/9999-Р-ЖД-01-КР-общий.rvt)
Дисциплина ИОС (ОВ) (RSN://vpp-revit19_12.main.picompany.ru/9999_Отдел внедрения BIM/Корпус 01/53_ОВ/9999-Р-ЖД-01-ОВ-общий.rvt)
Кнопка “Запустить проверку для указанных инспекций” - [Выбрать всё]
Кнопка “Какие инспекции должны выполняться в текущем проекте?”
Повторный запуск инспекции (обновление)
Окончательная проверка “Выпуск” (согласование/примечание/выпуск)
- При наличии ошибок, указать их в примечании;
- Добавить скриншоты ошибок с комментариями после заполненной таблицы;
Тестирование нового функционала:
- При тестировании готового продукта необходимо проверять выполнение всех пунктов из ТЗ;
- Необходимо реализовывать случаи возможных ошибок, описанных в ТЗ;
- Необходимо проверять продукт на предмет отказоустойчивости, например:
- Запустить команду 2 раза подряд, проверить факт выполнения;
- Во время тестирования переключить документ и проверить поведение плагина;
- Выполнять тестирование минимум дважды:
- На тестовом файле;
- На рабочем файле проекта;
Сервера баз данных для BIM Inspector:
Разработка (dev) - http://10.177.202.72:5002
Тестирование (stage) - http://10.177.202.72:5001
Продуктовый (prod) - http://10.177.202.72:5000
Сервер BIM Inspector: vpp-bimins01;
База данных размещена на сервере "vpp-inspectordb"
По окончанию разработки плагина необходимо разработать инструкцию к проверке/плагину для пользователей по форме шаблона.
Шаблон инструкции. Папка с инструкциями BIM Inspector.
После завершения тестирования и подготовки инструкции заполняется чек-лист готовности к релизу, находящийся в каждой задаче. Без заполненного чек-листа функционал не может уйти в релиз. С учетом специфики сервиса BIM Inspector релиз будет отложен до тех пор пока все этапы тестирования по задачам входящим в текущий релиз не будут закрыты:
Релизы сервиса BIM Inspector проходят не чаще чем 1 раз в 2 недели по понедельникам. В релиз включаются задачи, которые вошли в релизную версию, прошли тестирование и имеют подготовленную инструкцию. С учетом невозможности зарелизить отдельные задачи, вошедшие в релизную сборку, релиз может быть отложен до завершения тестирования по всем задачам входящим в релиз. В этом случае дата релиза может быть перенесена на ближайшую дату в интервале вторник - четверг (релизы по пятницам не проводятся). Допускается релиз новой функции без наличия инструкции при условии, что данный функционал не будет включен до появления инструкции.
Дату ближайшего релиза можно узнать на странице "История версий".
Если в процессе работы сервиса выявлены критические баги, которые могут привести к стабильности работы сервиса или корректности выдаваемых результатов имеющие массовый характер, такие исправления выпускаются как хотфиксы по ускоренной схеме не привязанной к периодичности релизов.
В случае, если в работе плагина наблюдаются ошибки - необходимо фиксировать их как замечания. Замечания могут быть замечаниями после релиза плагина. Для создания замечания для проверки/плагина после релиза необходимо:
Создать задачу в Asana в колонке "Ошибки";
В содержании задачи необходимо указать:
Описание проблемы, возникшей в ходе эксплуатации проверки/плагина;
Последовательность действий, которая привела к проблеме;
Скриншоты ошибок;
Результат, требуемый по факту разрешения проблемы;
Id элемента/элементов (Управление - Сведения - Код выбора);
Вид/виды, содержащие необходимые элементы, с помощью которых можно реализовать ситуацию с ошибкой;
Доработка требуется в случаях, если:
Необходимо внесение изменений в текущий функционал;
Необходимо создание новых функций разработки, которые не были предусмотрены в ТЗ первой версии;
Для создания доработки необходимо:
Создать задание на доработку в формате задачи в Asana в колонке “ЗАДАЧИ (TODO)”. В содержании задачи указать ссылку на ТЗ;
Все изменения по старым пунктам, а также добавление новых необходимо фиксировать в ТЗ:
В п.3.5 "Задание на доработку версии Х.Х.Х";
В таблице 2 "Версионность разработки" добавить ссылку на раздел с описанием доработки и кратко описать добавленные/измененные пункты с указанием версии разработки. Версионность проверки/плагинов 3х-значная, например - 1.0.2, где:
1 - кардинальные изменения в логике клиента/плагина;
0 - доработка существующего функционала;
2 - исправление ошибок релизной версии клиента/плагина;