МАТЕРИАЛЫ КУРСА
СИИ • НАВИГАЦИЯ

Лаборатория 3: Прототипирование MVP

Первый рабочий прототип с базовой функциональностью, API, базой данных и baseline AI моделью

~15 МИН ЧТЕНИЯ
ОБНОВЛЕНО НЕДАВНО

🚀 Лабораторная 3: Прототипирование MVP

📊 Sprint Dashboard

14 дней
Спринт 3
Код работает
MVP прототип
12 артефактов
По всем ролям
10 баллов
Максимальная оценка

Основной вопрос спринта

"Работает ли концепция?"

Команда должна доказать техническую осуществимость проекта через работающий код: API отвечает, база данных хранит, AI модель генерирует.

🎯 Задачи по ролям

FULLSTACK ENGINEER

Создание каркаса приложения, API и базового UI

Ответственность

Создать работающий каркас фронтенда и бэкенда: React интерфейс взаимодействует с FastAPI, данные сохраняются в БД, есть интеграция с AI моделью.

Каркас фронтенда

Время: 6-8 часов
Задачи:
  • Базовая структура Next.js приложения
  • 3-5 ключевых страниц по use-cases
  • Tailwind CSS стили и layout
  • Компоненты для отображения AI ответов
Результат:frontend/src/app/ + components/

FastAPI сервис

Время: 5-7 часов
Задачи:
  • Базовая структура FastAPI проекта
  • 5-7 эндпоинтов по use-cases
  • Pydantic модели для валидации
  • CORS и middleware настройка
Результат:backend/app/main.py + routers/

Интеграция с БД

Время: 4-5 часов
Задачи:
  • SQLAlchemy/Prisma модели данных
  • Миграции базы данных
  • CRUD операции для сущностей
  • Хранение результатов AI
Результат:backend/models/ + migrations/

Интеграция bolt.ai/V0

Время: 3-4 часа
Задачи:
  • Быстрое прототипирование UI через bolt.ai
  • Генерация компонентов React
  • Адаптация кода под проект
  • Документирование процесса
Результат:docs/bolt-integration.md

Итоговые артефакты

FULLSTACK
frontend/src/app/ — Next.js приложение
backend/app/main.py — FastAPI сервис
backend/models/ — Модели БД
docs/bolt-integration.md
AI ENGINEER
ml/models/baseline.py
ml/tracing/langfuse_config.py
notebooks/baseline_experiments.ipynb
backend/routers/ai.py
MLOPS
docker-compose.yml
backend/Dockerfile + frontend/Dockerfile
docker-compose.langfuse.yml
.github/workflows/ci.yml
SA/PO
docs/requirements-v2.md
docs/architecture/c4-actual.md
docs/sprint4-plan.md
docs/integration-report.md

🎯 Definition of Done (DoD)

Технические требования

Все 12 артефактов созданы и работают
FastAPI сервер запускается и отвечает на запросы
Next.js приложение отображает страницы
БД принимает подключения и сохраняет данные
AI модель отвечает на тестовые запросы

⏱️ График работы (14 дней)

Неделя 1: Разработка

Дни 1-3: Backend + Database

  • • Fullstack: FastAPI каркас, модели БД
  • • AI Engineer: Baseline модель, первые промпты
  • • MLOps: Dockerfiles для сервисов
  • • SA/PO: Проверка требований, синхронизация

Дни 4-5: Frontend + AI

  • • Fullstack: Next.js страницы, компоненты
  • • AI Engineer: Интеграция Langfuse, эксперименты
  • • MLOps: Docker Compose, настройка
  • • SA/PO: Обновление архитектуры

Дни 6-7: Интеграция

  • • Fullstack: Связка Frontend ↔ Backend
  • • AI Engineer: API endpoints для модели
  • • MLOps: Langfuse deployment
  • • SA/PO: Интеграционное тестирование
Неделя 2: Полировка

Дни 8-10: Тестирование

  • • Все роли: End-to-end тестирование
  • • Исправление критических багов
  • • Оптимизация производительности
  • • Улучшение UX/UI

Дни 11-12: Автоматизация

  • • MLOps: GitHub Actions финализация
  • • AI Engineer: Метрики baseline модели
  • • Fullstack: Обработка ошибок, валидация
  • • SA/PO: Планирование Спринта 4

Дни 13-14: Сдача

  • • Создание Pull Request'ов
  • • Peer review артефактов
  • • Финальная документация
  • • Подготовка демо для презентации

📋 Чек-лист для самопроверки

✅ Перед созданием PR проверьте

🔧 Техническое

docker-compose up запускает все сервисы
Frontend доступен на localhost:3000
Backend API отвечает на запросы
БД сохраняет данные корректно
AI модель генерирует ответы
Langfuse логирует все LLM вызовы

📚 Документация

README обновлен с инструкциями
.env.example содержит все переменные
API документация актуальна
Архитектура задокументирована
Есть скриншоты/видео демо
GitHub Actions проходит успешно

🔗 Полезные ссылки


ВСЕ МАТЕРИАЛЫ