🐍 HR Telegram Bot

📌 Описание проекта

Телеграм-бот для HR-отдела компании 'Роданика', помогающий работать с откликами на вакансии и автоматизировать первичный скрининг кандидатов.

📅 Команды бота

• /start - Начало работы с ботом, показывает приветственное сообщение и основные команды
• /vacancies - Отображает список доступных вакансий с кратким описанием
• /dialog - Запускает диалог с кандидатом по скрипту
• /status - Позволяет установить или изменить статус кандидата
• /rejection - Указывает причину отказа (со стороны компании или кандидата)
• /analytics - Показывает базовую статистику по кандидатам и вакансиям

📌 1. Диалог с кандидатом по скрипту

Бот проводит структурированный диалог с кандидатами в несколько этапов:

• Приветствие и представление компании: Бот представляется от имени HR-специалиста и компании
• Сбор информации о кандидате: Получение имени и фамилии
• Презентация вакансии: Представление доступных позиций в компании
• Выявление заинтересованности: Уточнение интереса кандидата к вакансии
• Приглашение на собеседование: Если кандидат заинтересован
• Подтверждение встречи: Получение подтверждения о готовности прийти на собеседование

📌 2. Управление вакансиями

• Отображение списка активных вакансий через команду /vacancies
• Информация о вакансиях хранится в JSON-формате и может быть легко обновлена

📌 3. Система статусов кандидатов

Бот автоматически фиксирует и позволяет вручную изменять статусы кандидатов:

📌 4. Фиксация причин отказа

Бот позволяет указывать и хранить причины отказа:

• Со стороны компании:
• Со стороны кандидата:

📌 5. Аналитика и отчеты

📌 Установка и настройка:

🔧 Предварительные требования:

• 
• Виртуальное окружение (рекомендуется)

1. 📌 Клонируйте репозиторий:

   git clone https://github.com/AndreyBychenkow/AssignmentHrBot.git

2. 📌 Создание и активация виртуального окружения:

# Создание виртуального окружения
python -m venv venv

# Активация в Windows
venv\Scripts\activate

# Активация в Linux/Mac
source venv/bin/activate

3. 📌 Установите зависимости:

   pip install -r requirements.txt   

4. 📌 Настройка переменных окружения:

Создайте файл .env в корне проекта и добавьте необходимые переменные окружения:

TELEGRAM_TOKEN='your telegram bot token'
LOG_LEVEL=INFO
COMPANY_NAME='РОДАНИКА'

🚀 Запуск бота

   python main.py  

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

hr-telegram-bot/
├── main.py                    # Точка входа в приложение
├── .env                       # Файл с переменными окружения
├── requirements.txt           # Зависимости проекта
├── candidates.json            # Хранилище данных о кандидатах
├── vacancies.json             # Хранилище данных о вакансиях
├── analytics.csv              # Экспортированная аналитика
└── bot/                       # Пакет с кодом бота
    ├── __init__.py            # Инициализация пакета
    ├── bot.py                 # Основной класс бота
    ├── config.py              # Настройки и конфигурация
    ├── handlers/              # Обработчики команд и диалогов
    │   ├── __init__.py
    │   ├── command_handlers.py # Обработчики команд
    │   └── dialog_handlers.py  # Обработчики диалогов
    ├── scripts/               # Скрипты диалогов
    │   ├── __init__.py
    │   └── dialog.py          # Текстовые сценарии диалогов
    ├── database/              # Работа с хранилищем данных
    │   ├── __init__.py
    │   └── storage.py         # Класс для работы с данными
    └── utils/                 # Вспомогательные утилиты
        ├── __init__.py
        └── analytics.py       # Класс для аналитики