Skip to content

SETUP.md

Latest commit

 

History

History
134 lines (91 loc) · 4.39 KB

SETUP.md

File metadata and controls

134 lines (91 loc) · 4.39 KB

🚀 Быстрая установка и запуск

Эта инструкция для Марка - как быстро запустить проект на Windows.

✅ Требования

  • Python 3.8+ установлен на компьютере
  • Интернет для установки библиотек
  • Telegram на телефоне

Если Python не установлен - скачай с python.org

🎯 Быстрый старт (3 шага)

Шаг 1: Получить токен бота

  1. Открой Telegram
  2. Найди @BotFather
  3. Напиши /newbot
  4. Придумай имя: HR Helper
  5. Придумай username: your_name_hr_bot (должен заканчиваться на _bot)
  6. Скопируй токен который пришлет BotFather

Шаг 2: Настроить config.py

  1. Открой файл config.py в блокноте
  2. Найди строку BOT_TOKEN = 'YOUR_BOT_TOKEN_HERE'
  3. Замени YOUR_BOT_TOKEN_HERE на твой токен от BotFather
  4. Сохрани файл

Пример:

BOT_TOKEN = '7618288124:AAGn0o6MGuiPKMACglzC51pXrHFDiYERMhc'

Шаг 3: Запустить бота

Способ 1 (самый простой):

  1. Двойной клик по файлу start.bat
  2. Готово!

Способ 2 (через командную строку):

# Открыть командную строку в папке проекта
python -m venv venv
venv\Scripts\activate
pip install -r requirements.txt
python main.py

📱 Проверка работы

  1. Найди своего бота в Telegram (по username который создал)
  2. Напиши /start
  3. Должны появиться кнопки меню
  4. Попробуй команду /news

Если работает - всё готово! ✅

🎬 Демонстрация преподавателю

Смотри файл DEMO.md - там подробный сценарий демонстрации с примерами.

Ключевые моменты для демонстрации:

  1. Telegram бот с кнопками
  2. Массовая рассылка через API (Postman)
  3. Добавление новостей через API
  4. Автоматическое уведомление пользователей

❓ Проблемы и решения

Python не найден

Проблема: 'python' is not recognized...

Решение:

  1. Скачай Python с python.org
  2. При установке обязательно поставь галочку "Add Python to PATH"
  3. Перезагрузи компьютер
  4. Попробуй снова

Токен не работает

Проблема: Бот не отвечает в Telegram

Решение:

  1. Проверь что токен правильно скопирован в config.py
  2. Токен должен быть в кавычках
  3. Не должно быть пробелов в начале/конце
  4. Перезапусти start.bat

Порт 5001 занят

Проблема: Address already in use при запуске

Решение:

  1. Открой main.py и api.py
  2. Найди port=5001
  3. Замени на port=5002 (или другой свободный порт)
  4. Сохрани и перезапусти

📊 Для демонстрации понадобится

  1. ✅ Запущенный бот (start.bat)
  2. ✅ Postman установлен (скачать)
  3. ✅ Telegram открыт на телефоне
  4. ✅ Файл DEMO.md под рукой

💡 Советы

  • Запускай start.bat перед демонстрацией
  • Проверь что бот отвечает в Telegram
  • Проверь что API работает: открой в браузере http://localhost:5001/api/health
  • Подготовь примеры JSON для Postman (они есть в DEMO.md)

Готово! Удачи на защите! 🎓

Если что-то не работает - перечитай эту инструкцию или посмотри README.md.