# 🎯 Чеклист подготовки к Demo Day

> Полное руководство по подготовке проекта к финальной презентации

## 📋 Обзор

Demo Day — это финальное мероприятие курса, где каждая команда представляет свой проект за **15 минут** (10 минут презентация + 5 минут Q&A).

**Оценка**: 10 баллов
- 4 балла — качество презентации
- 4 балла — демонстрация работающего продукта
- 2 балла — ответы на вопросы

---

## ✅ Обязательные материалы

### 1. README.md в репозитории

**Статус**: ⬜ Не готово | ⬜ В процессе | ⬜ Завершено

Используйте [шаблон README](PROJECT_README_TEMPLATE.md) и заполните все секции:

- [ ] Описание проекта и проблемы
- [ ] Информация о команде с GitHub профилями
- [ ] Архитектура системы с диаграммой
- [ ] Технологический стек (AI, Backend, Frontend, DevOps)
- [ ] Инструкции по установке и запуску
- [ ] Скриншоты интерфейса
- [ ] Ссылка на видео демонстрацию
- [ ] Метрики производительности
- [ ] Результаты A/B тестов (если есть)
- [ ] Документация API
- [ ] Извлеченные уроки

**Где хранить**: `README.md` в корне репозитория

---

### 2. Презентация (PDF)

**Статус**: ⬜ Не готово | ⬜ В процессе | ⬜ Завершено

#### Структура презентации (рекомендуемая)

**Всего: 10-12 слайдов на 10 минут**

1. **Титульный слайд** (1 слайд)
   - [ ] Название проекта
   - [ ] Emoji/Логотип
   - [ ] Команда с ролями и фото
   - [ ] Дата Demo Day

2. **Проблема** (1-2 слайда) — Роль: Product/VO
   - [ ] Какую проблему решаем
   - [ ] Почему это важно (статистика, примеры)
   - [ ] Целевая аудитория

3. **Решение** (2 слайда) — Роль: Product/VO + AI Engineer
   - [ ] Как наша AI-система решает проблему
   - [ ] Уникальность подхода
   - [ ] Схема AI pipeline с визуализацией

4. **Технологии** (1 слайд) — Роль: AI Engineer + Delivery
   - [ ] AI стек (LLM, VLM, RAG, Langfuse)
   - [ ] Backend/Frontend технологии
   - [ ] Infrastructure (Docker, CI/CD, Grafana)

5. **Демо работы** (2-3 слайда) — Роль: Delivery
   - [ ] Скриншоты ключевых экранов
   - [ ] User flow с примером
   - [ ] Отметка "Сейчас покажем live demo"

6. **Метрики и результаты** (1-2 слайда) — Роль: Quality + AI Engineer
   - [ ] Производительность (latency, token usage)
   - [ ] Результаты A/B тестов
   - [ ] Test coverage, CI/CD статус
   - [ ] Grafana/Langfuse дашборды

7. **Извлеченные уроки** (1 слайд) — Роль: Product/VO
   - [ ] Что сработало хорошо
   - [ ] Главные челленджи и как их решили
   - [ ] Технические инсайты

8. **Roadmap** (1 слайд) — Роль: Product/VO
   - [ ] Что реализовано (MVP → Production → Testing)
   - [ ] Что планируем в будущем (v2.0)

9. **Спасибо + Контакты** (1 слайд)
   - [ ] GitHub репозиторий
   - [ ] Ссылки на команду
   - [ ] QR-код на проект (опционально)

#### Требования к дизайну

- [ ] Читаемые шрифты (минимум 24pt для текста)
- [ ] Контрастные цвета
- [ ] Минимум текста, максимум визуалов
- [ ] Единый стиль на всех слайдах
- [ ] Высокое качество изображений

**Где хранить**: `docs/presentation.pdf` в репозитории

**Рекомендуемые инструменты**:
- Pitch.com
- Canva
- Google Slides
- PowerPoint
- Figma

---

### 3. Видео демонстрация (2-5 минут)

**Статус**: ⬜ Не готово | ⬜ В процессе | ⬜ Завершено

#### Что показать в видео

- [ ] **Вступление** (10 сек): название проекта, кто вы
- [ ] **Проблема** (20 сек): какую проблему решаем
- [ ] **Демо интерфейса** (2-3 мин):
  - [ ] Основной user flow от начала до конца
  - [ ] Ключевые фичи в действии
  - [ ] AI в работе (ввод → обработка → результат)
- [ ] **Behind the scenes** (30-60 сек, опционально):
  - [ ] Langfuse трейсинг
  - [ ] Grafana метрики
  - [ ] Docker Compose stack
- [ ] **Заключение** (10 сек): призыв попробовать, ссылки

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

- [ ] Разрешение: минимум 1080p
- [ ] Формат: MP4 (H.264)
- [ ] Длительность: 2-5 минут
- [ ] Качественный звук (микрофон, без шума)
- [ ] Субтитры (опционально, но рекомендуется)

**Где разместить**:
- YouTube (unlisted или public)
- Loom
- Google Drive (с открытым доступом)

**Ссылку добавить**:
- В README.md (секция "Демо и результаты")
- На слайд презентации

**Рекомендуемые инструменты**:
- OBS Studio (запись экрана)
- Loom (быстрая запись)
- DaVinci Resolve (монтаж)
- ScreenFlow (Mac)

---

### 4. Работающее демо

**Статус**: ⬜ Не готово | ⬜ В процессе | ⬜ Завершено

#### Чеклист готовности демо

**Docker Compose**
- [ ] `docker-compose up` запускает все сервисы
- [ ] Все сервисы стартуют без ошибок
- [ ] База данных инициализируется с тестовыми данными
- [ ] API доступен на `localhost:8000`
- [ ] Frontend доступен на `localhost:3000`
- [ ] Grafana доступен на `localhost:3001`
- [ ] Langfuse доступен на `localhost:3002`

**Функциональность**
- [ ] Основной use case работает от начала до конца
- [ ] UI отзывчивый и без очевидных багов
- [ ] LLM отвечает корректно (тестовые промпты)
- [ ] Данные сохраняются в БД
- [ ] Метрики отображаются в Grafana
- [ ] Трейсинг виден в Langfuse

**Подготовка к live demo**
- [ ] Заранее подготовленные примеры входных данных
- [ ] Plan B: если что-то сломается, есть записанное видео
- [ ] Тестовый прогон за день до Demo Day
- [ ] Ноутбук с достаточной мощностью
- [ ] Интернет для LLM API (проверить ограничения)

---

### 5. Документация проекта

**Статус**: ⬜ Не готово | ⬜ В процессе | ⬜ Завершено

#### Обязательные документы

**docs/architecture.md**
- [ ] ADR (Architecture Decision Records)
- [ ] Схема базы данных
- [ ] API архитектура
- [ ] Диаграммы компонентов

**docs/api.md**
- [ ] Список всех endpoints
- [ ] Request/Response примеры
- [ ] Коды ошибок
- [ ] Аутентификация (если есть)

**docs/deployment.md**
- [ ] Требования к окружению
- [ ] Инструкции по деплою
- [ ] Переменные окружения
- [ ] Troubleshooting

**.env.example**
- [ ] Все необходимые переменные окружения
- [ ] Комментарии для каждой переменной
- [ ] Значения по умолчанию (где применимо)

---

## 🎤 Распределение времени на презентации

**Общее время: 10 минут**

| Роль | Время | Что рассказывать |
|------|-------|------------------|
| **Product / Vision Owner** | 2-3 мин | Проблема, решение, roadmap, итоги |
| **AI Engineer** | 2-3 мин | AI pipeline, модели, промпты, A/B тесты |
| **Delivery Engineer** | 2-3 мин | Инфраструктура, CI/CD, мониторинг |
| **AI Quality & Safety Engineer** | 2-3 мин | UX, демо интерфейса, основные фичи |

**+ 5 минут Q&A**: вся команда отвечает на вопросы

---

## 📊 Метрики для презентации

Подготовьте **реальные цифры** для презентации:

### Производительность

- [ ] **API Response Time**: среднее, p95, p99
- [ ] **LLM Latency**: время ответа модели
- [ ] **Token Usage**: среднее количество токенов на запрос
- [ ] **Cost per Request**: стоимость одного запроса

### Качество

- [ ] **Test Coverage**: % покрытия тестами
- [ ] **CI/CD Success Rate**: % успешных билдов
- [ ] **Uptime**: % доступности системы
- [ ] **Error Rate**: % запросов с ошибками

### A/B Testing (если проводили)

- [ ] Гипотеза теста
- [ ] Метрики до/после
- [ ] Статистическая значимость
- [ ] Выводы

**Где взять метрики**:
- Grafana dashboards
- Langfuse analytics
- GitHub Actions logs
- Pytest coverage reports

---

## 🎨 Визуальные материалы

### Обязательные скриншоты

В папке `docs/screenshots/`:

- [ ] `home.png` — главная страница
- [ ] `demo-input.png` — ввод данных
- [ ] `demo-processing.png` — процесс обработки (опционально)
- [ ] `demo-result.png` — результат работы AI
- [ ] `grafana-dashboard.png` — Grafana метрики
- [ ] `langfuse-trace.png` — трейсинг в Langfuse
- [ ] `api-docs.png` — Swagger/OpenAPI документация

### Диаграммы

- [ ] AI Pipeline (mermaid или draw.io)
- [ ] Architecture diagram
- [ ] Database schema
- [ ] User flow

**Инструменты**:
- Mermaid (в README)
- Draw.io / Excalidraw
- Lucidchart
- Figma

---

## 🚀 Репозиторий GitHub

### Общие требования

- [ ] **Публичный репозиторий** (или доступ для преподавателя)
- [ ] **Описательное README.md** в корне
- [ ] **LICENSE** файл (MIT или другая)
- [ ] **.gitignore** правильно настроен
- [ ] **Нет секретов** в коде (API ключи, пароли)

### Структура проекта

```
project-name/
├── README.md                 # Главный README
├── LICENSE
├── .gitignore
├── .env.example             # Пример переменных окружения
├── docker-compose.yml       # Docker оркестрация
├── backend/                 # Backend код
│   ├── Dockerfile
│   ├── requirements.txt
│   ├── main.py
│   └── ...
├── frontend/                # Frontend код
│   ├── Dockerfile
│   ├── package.json
│   └── ...
├── docs/                    # Документация
│   ├── architecture.md
│   ├── api.md
│   ├── deployment.md
│   ├── presentation.pdf
│   └── screenshots/
├── tests/                   # Тесты
│   ├── unit/
│   ├── integration/
│   └── e2e/
└── .github/
    └── workflows/           # CI/CD
        └── ci.yml
```

### GitHub Insights

Перед Demo Day проверьте, что у вас есть:

- [ ] **Активные коммиты** от всех членов команды
- [ ] **Описательные commit messages**
- [ ] **Закрытые Issues** (показывают процесс разработки)
- [ ] **Pull Requests** с ревью (показывают командную работу)
- [ ] **GitHub Actions** успешно выполняются (зеленые галочки)
- [ ] **README badges** показывают статус проекта

---

## 🎯 Критерии оценки Demo Day

### Презентация (4 балла)

**Отлично (4 балла)**:
- Четкая структура и логика изложения
- Каждый член команды уложился во время
- Профессиональные слайды с визуалами
- Понятное объяснение технической части
- Показаны реальные метрики и результаты

**Хорошо (3 балла)**:
- Структура есть, но местами хаотично
- Небольшие проблемы со временем
- Слайды хорошие, но можно улучшить
- Технические детали понятны в целом

**Удовлетворительно (2 балла)**:
- Нет четкой структуры
- Проблемы с распределением времени
- Слайды текстовые, мало визуала
- Технические объяснения запутанные

**Неудовлетворительно (0-1 балл)**:
- Нет подготовки
- Превышено время или очень короткая презентация
- Плохое качество слайдов
- Не удалось объяснить технологии

### Демо (4 балла)

**Отлично (4 балла)**:
- Работает стабильно и без багов
- Показаны все ключевые фичи
- Live demo впечатляет
- Видно использование AI, мониторинг, CI/CD

**Хорошо (3 балла)**:
- Работает, но есть мелкие баги
- Основные фичи продемонстрированы
- Live demo прошло успешно
- Частично показан стек технологий

**Удовлетворительно (2 балла)**:
- Работает нестабильно
- Продемонстрированы не все фичи
- Пришлось использовать записанное видео
- Мало технических деталей

**Неудовлетворительно (0-1 балл)**:
- Не работает
- Нет рабочего демо
- Только скриншоты без функциональности

### Q&A (2 балла)

**Отлично (2 балла)**:
- Команда отвечает уверенно и по существу
- Показано глубокое понимание технологий
- Честные ответы про челленджи
- Интересная дискуссия

**Хорошо (1.5 балла)**:
- Отвечают на большинство вопросов
- Понимание технологий есть
- Некоторые вопросы вызвали затруднения

**Удовлетворительно (1 балл)**:
- Отвечают неуверенно
- Поверхностное понимание
- Много "не знаю"

**Неудовлетворительно (0 баллов)**:
- Не могут ответить на базовые вопросы
- Нет понимания того, что делали

---

## 📅 Таймлайн подготовки

### За 2 недели до Demo Day

- [ ] Начать работу над презентацией
- [ ] Собрать скриншоты приложения
- [ ] Проверить работоспособность демо
- [ ] Начать заполнять README.md

### За 1 неделю до Demo Day

- [ ] Завершить черновик презентации
- [ ] Записать черновик видео демо
- [ ] Собрать все метрики из Grafana/Langfuse
- [ ] Написать документацию (architecture, API, deployment)
- [ ] Провести репетицию внутри команды

### За 3 дня до Demo Day

- [ ] Финализировать презентацию
- [ ] Записать финальное видео демо
- [ ] Завершить README.md
- [ ] Протестировать live demo на разных окружениях
- [ ] Подготовить запасной план (если демо сломается)

### За 1 день до Demo Day

- [ ] Финальная репетиция с таймингом
- [ ] Проверить все ссылки в README
- [ ] Убедиться что презентация открывается
- [ ] Проверить что видео воспроизводится
- [ ] Зарядить ноутбук 🔋

### В день Demo Day

- [ ] Прийти за 15 минут до начала
- [ ] Проверить проектор/подключение к экрану
- [ ] Открыть все необходимое (презентация, демо, терминал)
- [ ] Глубокий вдох и улыбка 😊

---

## 💡 Советы для успешной презентации

### Общие рекомендации

✅ **DO**:
- Репетируйте несколько раз всей командой
- Говорите уверенно, даже если волнуетесь
- Используйте визуалы вместо текста на слайдах
- Рассказывайте историю, а не просто факты
- Показывайте энтузиазм к проекту
- Будьте честны про трудности и как их решили
- Держите зрительный контакт с аудиторией

❌ **DON'T**:
- Читать текст со слайдов
- Перегружать слайды информацией
- Извиняться за недоработки (просто не показывайте их)
- Использовать жаргон без объяснения
- Превышать время (жесткий лимит 10 минут)
- Показывать нерабочие фичи
- Паниковать если что-то пошло не так

### Работа с вопросами

- Внимательно выслушайте вопрос до конца
- Если не поняли — попросите уточнить
- Если не знаете ответа — честно скажите "Не знаем, но можем разобраться"
- Отвечает тот, кто лучше знает эту область
- Не спорьте с аудиторией, даже если не согласны
- Благодарите за вопросы

---

## 🎁 Бонусные баллы (опционально)

Хотите выделиться? Попробуйте добавить:

- [ ] **Интерактивное демо**: QR-код для доступа к живому приложению
- [ ] **Инфографика/Poster**: красивый постер проекта (A3)
- [ ] **Swag**: стикеры, мерч с логотипом проекта
- [ ] **Blog post**: статья на Medium/Habr о проекте
- [ ] **Open Source вклад**: если использовали библиотеки, сделали PR
- [ ] **Публичный деплой**: рабочее приложение на реальном домене
- [ ] **Telegram бот**: демо через бота для удобства

---

## 📞 Помощь и поддержка

Если нужна помощь с подготовкой:

1. **Вопросы по инфраструктуре**: напишите в чат курса
2. **Технические проблемы**: создайте Issue в репозитории
3. **Вопросы по презентации**: обсудите с Product/VO команды
4. **Общие вопросы**: [@chs_23](https://t.me/chs_23)

---

## ✅ Финальный чек-лист перед Demo Day

Распечатайте и отметьте галочками:

### Репозиторий
- [ ] README.md заполнен полностью
- [ ] Презентация (PDF) в `docs/presentation.pdf`
- [ ] Видео демо загружено и ссылка добавлена
- [ ] Скриншоты в `docs/screenshots/`
- [ ] .env.example создан
- [ ] Нет секретов в коде
- [ ] Все ссылки рабочие

### Демо
- [ ] `docker-compose up` работает
- [ ] Все сервисы запускаются
- [ ] Основной use case работает
- [ ] Подготовлены примеры для демо
- [ ] Есть план B (видео)

### Презентация
- [ ] 10-12 слайдов готовы
- [ ] Распределены роли и тайминг
- [ ] Прошли репетицию
- [ ] Презентация проверена на ноутбуке
- [ ] Все визуалы высокого качества

### Команда
- [ ] Все знают свои части
- [ ] Прорепетировали Q&A
- [ ] Знаем про метрики проекта
- [ ] Готовы к вопросам
- [ ] Заряженные и выспавшиеся 😴

---

<div align="center">
  <h2>🚀 Удачи на Demo Day! 🚀</h2>
  <p>Вы проделали огромную работу. Теперь покажите всем, что вы создали!</p>
</div>