Лаба 1: Артефакты инициации

Подробное описание всех deliverables и критериев готовности для первой лабораторной работы

~15 МИН ЧТЕНИЯ

ОБНОВЛЕНО НЕДАВНО

Лабораторная 1: Инициация

ПЕРВЫЙ РАЗ НА КУРСЕ?

Перед началом работы обязательно прочитайте пошаговую инструкцию и глоссарий терминов в конце документа!

Спринт 1

2 недели

Презентация

На 2-й лекции

ФОРМАТ СДАЧИ

Все артефакты сдаются через Pull Request в GitHub с чек-листом DoD в описании.
Ветка: d#-название-артефакта, PR: D# — Название артефакта

Главный вопрос спринта

"Какую проблему решаем?"

Команда должна четко сформулировать проблему, выбрать подходящий AI-проект и распределить роли между участниками.

Итоговая презентация

На 2-й лекции — Презентация "Я понял проект как..."

Структура выступления:

Я понял проект как... (общее видение)
Я понял задачу как... (техническая формулировка)
Я вижу путь реализации как... (архитектура решения)
Я отвечаю за... (роль в команде)

Обязательные требования к презентации:

Команда записана в Google таблицу с указанием ролей участников (ссылка будет в Telegram канале)
Команда зарегистрирована в GitHub Classroom (ссылка будет в Telegram канале)
Артефакты D1-D4 подготовлены и готовы к сдаче через PR
Единое понимание проекта и готовность к реализации

ВАЖНО ПЕРЕД ПРЕЗЕНТАЦИЕЙ

Без регистрации команды в Google таблице и GitHub Classroom презентация не засчитывается. Ссылки на регистрацию публикуются в Telegram канале курса.

Deliverables

D1 — PRD (Product Requirements Document)

КРИТИЧНЫЙ ПРИОРИТЕТ SA/PO

Краткий документ с постановкой задачи и требованиями к продукту.

Время: 6-8 часов
Основная роль: SA/PO
Поддержка: AI Engineer, Fullstack

Компоненты:

Сегменты пользователей (2-3 целевые группы)
Pain Points (основные проблемы пользователей)
Use-cases (3-5 ключевых сценариев использования)
Value Proposition (уникальная ценность продукта)
North Star Metric (главная метрика успеха)

Definition of Done:

Определены 2-3 четких сегмента пользователей с описанием

Сформулированы 3-5 конкретных болей пользователей

Описаны 3-5 основных use-cases с примерами

Четко сформулирована value proposition в 1-2 предложениях

Определена измеримая North Star Metric с целевыми значениями

Документ оформлен в README.md в корне репозитория

Получен письменный ОК от ментора в Telegram: "PRD выглядит хорошо" или комментарий в GitHub

D2 — Use-case Narrative

КРИТИЧНЫЙ ПРИОРИТЕТ FULLSTACK

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

Время: 4-6 часов
Основная роль: Fullstack
Поддержка: SA/PO

Компоненты:

Happy Path (основной успешный сценарий)
Alternative Flows (альтернативные сценарии)
Error Handling (обработка ошибок)
User Value (ценность для пользователя)
Use-case UML диаграммы

Definition of Done:

Описан детальный Happy Path для основного use-case

Определены минимум 2 альтернативных сценария (например: нет интернета, неправильный ввод)

Описано минимум 3 сценария ошибок: технический сбой, некорректный ввод, превышение лимитов

Для каждого сценария указана конкретная ценность (экономия времени, снижение ошибок, etc.)

Созданы Use-case UML диаграммы (минимум 1 основная)

Документ сохранен как docs/use-cases.md

Проведен walkthrough всех сценариев с командой, получен ✅ от каждого участника

D3 — Stakeholder Map

ВЫСОКИЙ ПРИОРИТЕТ SA/PO

Карта заинтересованных сторон и их влияния на проект.

Время: 2-3 часа
Основная роль: SA/PO
Поддержка: All team

Компоненты:

Primary Stakeholders (основные заинтересованные стороны)
Secondary Stakeholders (вторичные стороны)
Influence Level (уровень влияния)
Interest Level (уровень заинтересованности)
Communication Strategy (стратегия взаимодействия)

Definition of Done:

Определено минимум 5 stakeholders из 3 категорий: пользователи (2), команда разработки, ментор/преподаватель, внешний эксперт

Для каждого stakeholder определен уровень влияния по шкале 1-3 (1-низкий, 2-средний, 3-высокий)

Для каждого stakeholder определен уровень заинтересованности по шкале 1-3

Заполнена таблица 5x4: stakeholder | влияние | интерес | стратегия работы

Для каждого stakeholder указана конкретная стратегия: информировать/консультироваться/вовлекать/управлять

Документ оформлен как docs/stakeholders.md

Получен письменный ОК от ментора в Telegram или комментарий в GitHub

D4 — RACI Matrix

ВЫСОКИЙ ПРИОРИТЕТ SA/PO

Матрица ответственности по задачам проекта для всех ролей команды.

Время: 3-4 часа
Основная роль: SA/PO
Поддержка: All team

Компоненты:

Task Breakdown (разбивка основных задач проекта)
Role Assignments (назначение ролей)
RACI определения (Responsible, Accountable, Consulted, Informed)
Decision Making Process (процесс принятия решений)
Escalation Path (путь эскалации конфликтов)

Definition of Done:

Определено 8-12 областей ответственности из списка в FAQ + 2-3 специфичных для проекта

Для каждой области назначены роли: R-выполняет, A-отвечает, C-консультирует, I-информируется

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

Указан процесс принятия решений: кто имеет финальное слово при конфликтах (обычно SA/PO)

Описан 3-шаговый процесс эскалации: обсуждение в команде → решение SA/PO → обращение к ментору

Матрица оформлена в виде таблицы в docs/raci.md с 4 колонками: Область ответственности | SA/PO | AI Eng | MLOps | Fullstack

Все участники поставили свою подпись/ник под таблицей: "Согласен с распределением ролей - @username"

✅ САМОПРОВЕРКА ПЕРЕД ОТПРАВКОЙ

📋 ЧЕК-ЛИСТ ПЕРЕД PR

Все DoD критерии выполнены

Документы сохранены в правильных папках

Команда согласна с контентом

Получен ОК от ментора

PR создан с правильным названием

⏱️ ВРЕМЕННЫЕ РАМКИ

D1 (PRD): дни 5-7 (6-8 часов)

D2 (Use-cases): дни 8-10 (4-6 часов)

D3 (Stakeholders): дни 11-12 (2-3 часа)

D4 (RACI): дни 12-13 (3-4 часа)

Общее время: 15-21 час на команду

Распределите нагрузку между участниками!

Как использовать DoD в PR

ЧЕК-ЛИСТ В PULL REQUEST

1. Скопируйте список критериев DoD в описание PR как чек-лист:


 Определены 2-3 четких сегмента пользователей с описанием

 Сформулированы 3-5 конкретных болей пользователей

 Описаны 3-5 основных use-cases с примерами

 Получен письменный ОК от ментора в Telegram

...

2. Отметьте выполненные пункты галочками: - [x] готово, - [ ] в работе

3. Все критерии [x] для принятия артефакта!

📚 ГЛОССАРИЙ ТЕРМИНОВ

PRD

Product Requirements Document - краткий документ с требованиями к продукту. В нашем случае: кто пользователи, что их беспокоит, что мы предлагаем.

North Star Metric

Главная метрика успеха проекта. Например: "Количество успешно выполненных AI-задач в день" или "Процент довольных пользователей".

Stakeholder

Заинтересованная сторона - человек или группа, которая влияет на проект или зависит от него. Например: пользователи, преподаватели, команда разработки.

RACI Matrix

Таблица ответственности: R-выполняет, A-отвечает за результат, C-консультирует, I-информируется. Помогает понять "кто за что отвечает".

Use-case

Сценарий использования - описание того, как пользователь будет взаимодействовать с системой для достижения цели.

Value Proposition

Ценностное предложение - короткое описание того, какую уникальную пользу приносит ваш продукт. Почему его стоит использовать.

🚀 ПОШАГОВАЯ ИНСТРУКЦИЯ "ЧТО ДЕЛАТЬ СНАЧАЛА"

ШАГ 1: ФОРМИРОВАНИЕ КОМАНДЫ (День 1-2)

1Найдите 3 других студента (итого команда из 4 человек)

2Распределите роли: SA/PO, AI Engineer, MLOps, Fullstack

3Выберите проект из каталога

4Запишитесь в Google таблицу (ссылка в Telegram)

ШАГ 2: НАСТРОЙКА РЕПОЗИТОРИЯ (День 3-4)

1Зарегистрируйтесь в GitHub Classroom (ссылка в Telegram)

2Создайте папку docs/ в репозитории

3Все участники должны иметь доступ к репозиторию

ШАГ 3: СОЗДАНИЕ АРТЕФАКТОВ (День 5-12)

1SA/PO начинает с D1 (PRD) - смотрите примеры ниже

2Fullstack делает D2 (Use-cases) параллельно

3SA/PO завершает D3 и D4 с участием всей команды

ШАГ 4: ПОДГОТОВКА К ПРЕЗЕНТАЦИИ (День 13-14)

1Создайте Pull Request для каждого артефакта с чек-листом DoD

2Подготовьте презентацию на 5-7 минут

3Каждый участник должен рассказать свою часть

📝 ПРИМЕРЫ И ШАБЛОНЫ

Пример D1 (PRD) для проекта "AI Plant Doctor":

ХОРОШИЙ ПРИМЕР PRD

Сегменты пользователей:

1. Начинающие садоводы (20-40 лет, живут в квартирах)

2. Дачники-любители (40-60 лет, есть опыт, но нужна помощь с диагностикой)

Pain Points:

1. Не знают, что не так с растением, когда листья желтеют

2. Тратят много времени на поиск информации в интернете

Value Proposition:

Сфотографируй растение - получи диагноз и план лечения за 30 секунд

North Star Metric:

80% диагнозов правильные (по отзывам пользователей через неделю)

ПЛОХОЙ ПРИМЕР PRD

Сегменты пользователей: Люди с растениями

Pain Points: У них проблемы с растениями

Value Proposition: Поможем с растениями

North Star Metric: Много пользователей

❌ Слишком абстрактно, нет конкретики и измеримости

❓ FAQ - ЧАСТЫЕ ВОПРОСЫ

❓ Сколько страниц должен быть каждый документ?

D1 (PRD) - 1-2 страницы, D2 (Use-cases) - 2-3 страницы, D3 (Stakeholders) - 1 страница, D4 (RACI) - 1 страница в виде таблицы.

❓ Что делать, если в команде конфликт по ролям?

Обратитесь к преподавателю в Telegram. Лучше решить это в первые дни, чем тянуть до презентации.

❓ Можно ли изменить проект после регистрации?

До начала работы над артефактами - да. После создания D1 - только с разрешения преподавателя.

❓ Что означает "согласовано с ментором" в DoD?

Покажите черновик преподавателю/ассистенту в Telegram, получите "ок" или комментарии.

❓ Как создать Pull Request с чек-листом?

В описании PR скопируйте все DoD критерии в формате "- [ ] Критерий". Отметьте галочками выполненные пункты.

📋 ШАБЛОНЫ И ПРИМЕРЫ ДЛЯ АРТЕФАКТОВ

🗂️ Шаблон Stakeholder Map (D3)

ШАБЛОН ТАБЛИЦЫ STAKEHOLDERS

Stakeholder	Влияние (1-3)	Интерес (1-3)	Стратегия работы
Начинающие садоводы	1	3	Информировать через демо
Команда разработки	3	3	Тесно управлять
Ментор курса	3	2	Консультироваться
Эксперт по садоводству	2	1	Периодически информировать
Опытные дачники	1	2	Получать обратную связь

📝 Области ответственности для RACI Matrix (D4)

12 КЛЮЧЕВЫХ ОБЛАСТЕЙ ДЛЯ RACI

🧠 AI/ML ОБЛАСТИ:

1. Выбор и настройка LLM/VLM моделей
Выбор GPT/Claude/Llama, настройка параметров

2. Промпт-инжиниринг и RAG
Создание промптов, настройка RAG цепочек

3. Данные и метрики качества
Сбор данных, оценка accuracy, latency

⚙️ MLOps ОБЛАСТИ:

4. Docker и контейнеризация
Docker Compose, образы, развертывание

5. CI/CD пайплайны
GitHub Actions, автоматизация тестов

6. Мониторинг и наблюдаемость
Langfuse, Grafana, логирование

💻 FULLSTACK ОБЛАСТИ:

7. UI/UX дизайн и интерфейс
React компоненты, Tailwind CSS

8. Backend API разработка
FastAPI, эндпоинты, интеграция с AI

9. Тестирование и QA
Unit тесты, интеграционные тесты, UX тесты

🏗️ ARCHITECT ОБЛАСТИ:

10. Архитектура системы
UML диаграммы, системный дизайн

11. Планирование и координация
Roadmap, спринты, управление рисками

12. Документация и презентация
ADR документы, демо, отчеты

Как использовать: Выберите 8-10 областей из списка + добавьте 2-3 специфичные для вашего AI-проекта (например, "Интеграция с WhatsApp API" или "Обучение кастомной модели")