Урок 88. Презентация проекта

📁 Блок: Финальный проект ⏱️ Время изучения: ~180 мин 🎯 Сложность: Продвинутая
#from #as #and #min #max #count #import #def #return #with #close #try #finally #list

⚡ Кратко: домашнее задание

Подготовьте проект к защите: репозиторий, README.md, проверка функционала и 5-минутная презентация.

  • Создайте репозиторий и загрузите туда финальную версию кода.
  • Напишите README.md с описанием, инструкциями по запуску и примерами.
  • Проверьте все сценарии: поиск по слову, по жанру/годам, статистику, выход.
  • Подготовьте 5-минутную презентацию с демонстрацией работы.

Что запомнить: защита проекта — это не только код, но и ваша способность объяснить его.

Частая ошибка: сдавать проект без README и не проверять работу на «чистой» машине.

🏠 Домашнее задание: подготовка и защита проекта

К уроку «Презентация проекта» у вас уже должен быть готовый проект. Домашняя работа заключается в том, чтобы привести его к защитному виду и подготовить рассказ.

Шаг 1. Создание репозитория

  1. Создайте новый репозиторий на GitHub / GitLab / другой платформе.
  2. Добавьте в .gitignore файлы, которые не должны попадать в Git: 
    __pycache__/
*.pyc
.env
.vscode/
.idea/
  3. Загрузите файлы проекта и убедитесь, что структура понятна: 
    movie_search/
├── main.py
├── mysql_connector.py
├── log_writer.py
├── log_stats.py
├── formatter.py
└── README.md

Шаг 2. Написание README.md

В README.md должны быть:

  • Название проекта и краткое описание.
  • Цель проекта — что делает приложение.
  • Технологии — Python, MySQL, MongoDB, PyMySQL, PyMongo.
  • Инструкции по запуску:
    1. Клонировать репозиторий.
    2. Установить зависимости: pip install -r requirements.txt.
    3. Указать реквизиты подключения (через .env или в коде для учебного сервера).
    4. Запустить: python main.py.
  • Примеры команд и ожидаемый вывод.
  • Структура проекта — краткое описание каждого модуля.

Шаг 3. Проверка функционала

Перед защитой пройдите по чек-листу:

  • Поиск по ключевому слову возвращает результаты и работает пагинация.
  • Поиск по жанру и годам показывает список жанров и диапазон годов.
  • После каждого поиска в MongoDB появляется новая запись.
  • Статистика показывает топ-5 популярных или последних запросов.
  • При вводе неверного пункта меню программа не падает.
  • При недоступности базы выводится понятное сообщение.
  • Код соответствует PEP8 (можно проверить через flake8).

Шаг 4. Подготовка 5-минутной презентации

Рекомендуемый план:

  1. Вступление (30 сек) — представьтесь, назовите проект.
  2. Описание (1 мин) — цель, технологии, структура модулей.
  3. Демонстрация (2 мин):
    • Поиск по ключевому слову.
    • Поиск по жанру и диапазону годов.
    • Просмотр популярных/последних запросов.
  4. Сложности и выводы (1 мин) — с чем столкнулись, что узнали.
  5. Ответы на вопросы (30 сек – входит в общее время).

Критерии приёма

  • Проект загружен на платформу за 1 день до презентации.
  • Все основные функции работают корректно.
  • Код структурирован, оформлен по PEP8, без дублирования.
  • Презентация укладывается в 5 минут и демонстрирует работу приложения.
💡 Совет: запишите себя на видео во время репетиции — так легче заметить лишние слова и неуверенные места.