1. Инструкция для пользователя:

Как выглядит приложение:

Релиз приложения состоит из архива со следующим содержимым:

├── 📁 Apps-Purchases-<your_platform_name>-latest/
│ ├── 📁 orders/
│ │ ├── 📁 final_reports/
│ │ │ └── 📄 Отчет о заявках за период - 2023 кв. 3 - 2024 кв. 3.xlsx
│ │ ├── 📁 main_template/
│ │ │ └── 📄 Шаблон заявки с справочниками.xlsx
│ │ ├── 📁 order_templates/
│ │ │ ├── 📄 10.09.2024.xlsx
│ │ │ └── 📄 файл 2.xlsx
│ └── 🖥️ Apps-Purchases-<your_platform_name>-latest.exe

• В папке final_reports находится пример сгенерированного отчета и эта папка является папкой по умолчанию для генерации отчетов.
• В папке main_template находится основной шаблон с актуальными справочниками, предполагается что этот отчет отправляется сотрудникам для формирования заявок на ПО.
• В папке order_templates находятся примеры полученных заявок на основе основного шаблона.
• Файл exe - основной файл для запуска приложения.

Как работать с приложением:

1. Скачиваем актуальный релиз под нужную платформу по ссылке с правой части экрана.
2. Распаковываем архив в папку.
3. Актуализируем основной шаблон в папке main_template.
4. Отправляем этот шаблон сотрудникам для формирования заявок на ПО.
5. Проверяем заявки, чтобы они соответствовали общему формату шаблона и все значения в заявках, Наименование ПО соответствовали значениям из соответствующих справочников (Пример: класс ПО в справочнике Наименование ПО должен полностью соответствовать значению из справочника классов ПО минкомсвязи, либо значению из справочника с другими классами).
6. Загружаем полученные файлы заявок-шаблонов в папку order_templates.
7. Открываем приложение нажатием на exe файл, либо обновляем заявки в приложении по нажатию на кнопку обновления.
8. Проверяем, что все файлы загрузились, если это не так, то нужно перепроверить загруженные файлы.
9. Фильтруем заявки по датам, выбираем нужные заявки в левой части.
10. Нажатием на кнопку выгрузки в правой нижней части, формируем итоговый отчет за указанный период.

Дополнительно:

Приложение так же позволяет просмотреть актуальные справочники.

2. Instructions for developers:

In this project, Python 3.11 was used.

2.1. Main instruction with uv tool (recommended)

In this project UV Project Manager was used, check its documentation and source code.

Install uv

# On macOS and Linux.
$ curl -LsSf https://astral.sh/uv/install.sh | sh

# On Windows.
$ powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

# With pip.
$ pip install uv

See the installation documentation for details and alternative installation methods.

Install and activate venv by sync command

Install venv and sync dependencies

uv sync

Activate venv

# На Windows:
$ .venv\Scripts\activate

# На macOS и Linux:
$ source .venv/bin/activate

Set up the git hook scripts by pre-commit

pre-commit install

Open ./src or main.py and just code it

Open your app

uv run main.py

2.2. Alternative instruction with pip tool (not recommended)

Install python 3.11

Install pip by this documentation

Install venv

Create venv

python -m venv .venv

Activate venv

# На Windows:
$ .venv\Scripts\activate

# На macOS и Linux:
$ source .venv/bin/activate

After that install dependencies

pip install .

Set up the git hook scripts by pre-commit

pre-commit install

Open ./src or main.py and just code it

Open your app

python main.py