Runbook выполнения и сдачи ПР

1. Запишите, где запускаете работу

1. Для ПР01–ПР04 выбрать одну из поддерживаемых сред.
2. Начните из нового терминала и запишите способ запуска, версии ОС, ROS 2, Gazebo и SHA материалов курса.
3. Для проектной среды и Gazebo-fixtures откройте project/config/baseline.lock.yaml текущего выпуска и проверьте хэш.
4. В Docker сохраните digest образа и подключите рабочее пространство и evidence/ как каталоги хоста.

2. Сначала покажите сбой, затем исправляйте

• сохранить минимальный сценарий до исправления;
• внести требуемое собственное изменение;
• назвать основную причину и повторить тот же тест после исправления;
• сохранить только нужные логи и фрагменты bag-файла, без секретов и персональных данных.

3. Запустить проверки

colcon build --symlink-install
colcon test
colcon test-result --verbose
python3 /path/to/course/tools/check_practice.py PR01 --submission .

PR01 заменяется на номер текущей работы. Конкретные package/fixture команды указаны на странице ПР и в стартовом пакете.

4. Соберите файлы результата

evidence/prNN/report.json содержит версию схемы, commit, команды, тесты, исходный сценарий, найденную причину, результат после исправления, фактическое время самостоятельной работы и признак использования ИИ. Если ИИ использовался, добавьте компактный AI_USAGE.md без полного чата и личных промптов.

5. Доработать на лабораторной

После автоматической проверки и короткого объяснения исправьте текущую ошибку. Если работа уже зачтена, используйте оставшееся время для следующей ПР. Работа на лабораторной не входит в указанное время самостоятельной доработки.