Инструкция по запуску проекта

Подготовка к работе

1. Установка Python

   • Если у вас еще не установлен Python, скачайте и установите его с официального сайта: https://www.python.org/downloads/
   • При установке обязательно поставьте галочку "Add Python to PATH"
   • Рекомендуется установить Python версии 3.8 или выше

2. Получение проекта

   • Если вы хотите получить проект через Git:
     • Убедитесь, что у вас установлен Git
     • Откройте командную строку в папке, куда хотите скопировать проект: Правой кнопкой мыши - Open Git Bash here
     • Выполните команду: git clone https://github.com/sandexzx/DataMatrixCode.git
   • Если вы получили проект в виде архива:
     • Распакуйте архив в удобное место на компьютере

Установка проекта

Windows

1. Запуск установки
   • Перейдите в папку с проектом
   • Найдите файл setup.bat
   • Дважды кликните по файлу setup.bat
   • Дождитесь завершения установки (это может занять несколько минут)
   • Если появится окно с сообщением об успешной установке, нажмите любую клавишу для закрытия

Linux

1. Запуск установки

   • Откройте терминал в папке проекта
   • Выполните команду: ./setup.sh
   • Дождитесь завершения установки

2. Что происходит при установке

   • Скрипт проверяет наличие Python
   • Создает виртуальное окружение
   • Устанавливает все необходимые библиотеки
   • Если возникнут ошибки, они будут показаны в окне

Запуск программы

Windows

1. Запуск основного скрипта
   • Перенесите исходный .xlsx файл в корневую директорию скрипта (папка DataMatrixCode)
   • В папке проекта найдите файл run.bat
   • Дважды кликните по файлу run.bat
   • Программа начнет работу

Linux

1. Запуск основного скрипта

   • Перенесите исходный .xlsx файл в корневую директорию скрипта
   • Выполните команду: ./run.sh
   • Программа начнет работу

2. Результаты работы

   • После завершения работы программы в папке проекта появится PDF файл с результатами
   • Также будет создан файл output.txt с дополнительной информацией (вытянутые из Excel коды)

Возможные проблемы и их решение

1. Если setup.bat не запускается

   • Убедитесь, что Python установлен корректно
   • Попробуйте запустить от имени администратора
   • Проверьте, что вы находитесь в правильной папке

2. Если run.bat не запускается

   • Убедитесь, что установка (setup.bat) прошла успешно
   • Проверьте наличие всех файлов в папке проекта
   • Попробуйте запустить от имени администратора

Дополнительная информация

• Все необходимые библиотеки указаны в файле requirements.txt
• Исходный код программы находится в папке src
• Временные файлы и виртуальное окружение находятся в папке .venv

Если у вас возникнут дополнительные вопросы или проблемы, обратитесь к разработчику проекта за помощью.