nis2/project-checkpoints/01-project-plan.md

Первая контрольная точка: план проекта и эксперимента

• Сдать материалы: до 03.11.2026, 23:59.
• Ветка: nis/checkpoint-1.

К первой точке команда описывает, что и как будет делать, и проверяет основные технические предпосылки проекта. Сквозной сценарий от входных данных до обработанных измерений потребуется ко второй точке.

Что сдать

Подготовьте три файла; по ссылкам доступны шаблоны:

• nis/project.md — ожидаемые результаты и способы их проверки, сценарии и упрощения;
• nis/experiment-plan.md — план сравнения и обработки результатов;
• nis/checkpoints/01.md — итоги технических проверок, команды запуска, ссылки на код и результаты, открытые риски и вклад каждого участника.

Откройте PR/MR из ветки nis/checkpoint-1 в main по правилам сдачи.

Описание проекта

В nis/project.md опишите ожидаемые результаты назначенного задания: что вы реализуете, какие проверки и эксперименты проведёте и какие материалы с результатами и их разбором подготовите. Для каждого пункта укажите, как проверить его выполнение. Ориентируйтесь на раздел «Обязательный результат» в карточке задания.

Укажите технический путь; если карточка предлагает несколько вариантов, выберите один. Опишите упрощения и их влияние на результаты. Существенное изменение обязательного объёма нужно согласовать с преподавателем и отразить в обновлённой карточке задания.

Технические проверки

Объём проверок зависит от пути проекта:

• Авторский артефакт: подготовьте код и данные, соберите используемые компоненты и запустите небольшой пример, связанный с заданием.
• Самостоятельная реализация: проверьте, хватает ли описания метода, и реализуйте минимальный прототип ключевой операции. Покажите его работу на простом входе с известным ожидаемым результатом.
• Симулятор, в том числе написанный самостоятельно: опишите допущения и выберите эталон — аналитический расчёт, опубликованные данные или доступную реализацию. Подготовьте простой случай для сравнения и получите эталонный результат. Если эталоном служит авторская программа, подготовьте её к работе и запустите на этом случае. Работающий прототип собственного симулятора и его сравнение с эталоном потребуются ко второй точке.

Укажите доступные ресурсы и оцените, хватает ли их для запланированной работы. Для основных метрик проверьте доступность нужных данных: подойдёт пробный замер, пример журнала с нужными полями или расчёт по доступным данным. Рядом с описанием каждой проверки укажите команду запуска или ссылку на инструкцию, ожидаемый и полученный результат и ссылки на материалы.

План эксперимента

К сдаче выберите baseline, данные или нагрузки и начальные конфигурации. Укажите, какие параметры будете менять и в каких пределах, какие серии и повторы проведёте. Для каждой метрики задайте определение, единицы и способ сбора; опишите проверку корректности и обработку результатов.

План должен позволять начать эксперименты. Масштаб нагрузки и диапазоны параметров можно уточнить после пробных запусков: отметьте такие решения и укажите, как и когда их примете. Готовая реализация baseline, полная серия измерений и итоговые выводы к первой точке не требуются.

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

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