Markirovka

Телеграм-бот и CLI-сервис для работы с кодами маркировки системы "Честный знак".

Основные функции

1. 🔍 Проверка кодов (/validate)

• Проверяет статус кодов через API Честного знака
• Использует кэширование (не проверяет повторно коды, проверенные менее 10 минут назад)
• Показывает понятный статус: ✅ в обороте, ❌ выбыл, ✔️ выпущен и т.д.

2. 📄 Извлечение из PDF (/extract)

• Ищет коды в многостраничных PDF-документах формата А4, сгенерированных в системе "Честный знак"
• Автоматически находит и "вырезает" области с кодами
• Создает новые PDF-файлы только с нужными кодами для печати
• Проверяет статусы найденных кодов

3. 📦 Свободные коды (/available)

• Автоматически находит свободные (не использованные) коды для конкретного товара
• Учитывает коды, переданные в обработку более 7 дней назад.
• Формирует готовые PDF для печати выбранных кодов

🚀 Быстрый старт

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

pip install -r requirements.txt

2. Создайте изолированный конфигурационный файл:

cp .env.example .env

3. Настройте токен бота в конфигурационном файле .env:

BOT_TOKEN=your_telegram_bot_token_here

4. Запустите:

• Бот: python bot.py
• CLI: python main.py

📁 Структура данных

Создайте папку data/pdf_files/ с подпапками для каждого товара:

pdf_files/
    ├── товар_1/
    │   ├── файл1.pdf
    │   └── файл1.txt (с кодами)
    ├── товар_2/
    │   ├── файл2.pdf
    │   └── файл2.txt

Коды для проверки в CLI режиме, помещайте в data/datamatrix.txt

---

Проект создан для упрощения работы с системой маркировки товаров

Такое описание:
- **Короткое** - только самая важная информация
- **Простое** - понятно даже новичкам
- **Структурированное** - легко найти нужный раздел
- **Практичное** - содержит конкретные инструкции для быстрого старта
- **Визуально приятное** - с эмодзи и четким разделением на блоки