385 lines
26 KiB
Plaintext
385 lines
26 KiB
Plaintext
Файл с партнерами: Partners_import.xlsx
|
||
Файл с типами продукции: Product_type_import.xlsx
|
||
Файл с продуктами: Products_import.xlsx
|
||
Файл с продажами: Partner_products_import.xlsx
|
||
|
||
###1 def calculate_discount(total_quantity):
|
||
"""Ра""Рассчитываетссчитывает скидку на основе общего количества проданной продукции
|
||
|
||
Args:
|
||
total_quantity (int): общее количество проданной продукции
|
||
|
||
Returns:
|
||
tuple: кортеж содержащий:
|
||
- discount_percent (int): процент скидки
|
||
- discount_description (str): текстовое описание скидки
|
||
|
||
Discount tiers:
|
||
- 15%: при объеме продаж от 300000 единиц
|
||
- 10%: при объеме продаж от 50000 до 300000 единиц
|
||
- 5%: при объеме продаж от 10000 до 50000 единиц
|
||
- 0%: при объеме продаж менее 10000 единиц
|
||
"""
|
||
###2 def get_partners(db_path='partners.db', sort_by='rating', ascending=False):
|
||
"""Получает данные о партнерах из базы данных с возможностью сортировки и расчета скидок
|
||
|
||
Args:
|
||
db_path (str): путь к файлу базы данных SQLite. По умолчанию 'partners.db'
|
||
sort_by (str): поле для сортировки. Допустимые значения:
|
||
- 'rating': по рейтингу (по умолчанию)
|
||
- 'discount': по общему количеству продаж (для расчета скидки)
|
||
- 'name': по наименованию партнера
|
||
- 'type': по типу партнера и наименованию
|
||
ascending (bool): направление сортировки.
|
||
- False: по убыванию (по умолчанию)
|
||
- True: по возрастанию
|
||
|
||
Returns:
|
||
pandas.DataFrame или None: DataFrame с данными партнеров или None в случае ошибки
|
||
|
||
Структура возвращаемого DataFrame:
|
||
- Тип партнера
|
||
- Наименование партнера
|
||
- Директор
|
||
- Электронная почта
|
||
- Телефон
|
||
- Юридический адрес
|
||
- ИНН
|
||
- Рейтинг
|
||
- Дата создания
|
||
- total_quantity: общее количество продаж (скрытое поле)
|
||
- Скидка: процент скидки на основе total_quantity
|
||
- Текст_скидки: текстовое описание скидки
|
||
|
||
Raises:
|
||
sqlite3.Error: ошибки работы с базой данных
|
||
Exception: другие возможные ошибки
|
||
|
||
Example:
|
||
>>> df = get_partners(sort_by='discount', ascending=True)
|
||
>>> df = get_partners('my_database.db', sort_by='name')
|
||
"""
|
||
### 3 def get_sales_history(db_path='partners.db', limit=50, sort_by='date_desc'):
|
||
"""Получает историю реализации продукции с разными вариантами сортировки
|
||
|
||
Args:
|
||
db_path (str): путь к файлу базы данных SQLite. По умолчанию 'partners.db'
|
||
limit (int): ограничение количества возвращаемых записей. По умолчанию 50
|
||
sort_by (str): критерий сортировки данных. Допустимые значения:
|
||
- 'date_desc': по дате продажи (новые сверху, по умолчанию)
|
||
- 'date_asc': по дате продажи (старые сверху)
|
||
- 'quantity_desc': по количеству (по убыванию)
|
||
- 'amount_desc': по общей сумме (по убыванию)
|
||
|
||
Returns:
|
||
pandas.DataFrame или None: DataFrame с историей продаж или None в случае ошибки
|
||
|
||
Структура возвращаемого DataFrame:
|
||
- Дата продажи: дата осуществления продажи
|
||
- Партнер: наименование партнера
|
||
- Продукция: название продукции
|
||
- Артикул: артикул продукции
|
||
- Количество: количество проданных единиц
|
||
- Цена за единицу: цена за одну единицу продукции
|
||
- Общая сумма: общая сумма продажи (рассчитывается как количество × цена)
|
||
- Тип продукции: категория продукции
|
||
|
||
Raises:
|
||
Exception: ошибки при выполнении запроса к базе данных
|
||
|
||
Example:
|
||
>>> # Получить последние 50 продаж
|
||
>>> df = get_sales_history()
|
||
|
||
>>> # Получить 100 самых крупных продаж по сумме
|
||
>>> df = get_sales_history(limit=100, sort_by='amount_desc')
|
||
|
||
>>> # Получить историю продаж в хронологическом порядке
|
||
>>> df = get_sales_history(sort_by='date_asc', limit=200)
|
||
"""
|
||
###4 def print_partner_cards(partners_df):
|
||
"""Выводит карточки партнеров в красивом формате с рамкой
|
||
|
||
Args:
|
||
partners_df (pandas.DataFrame): DataFrame с данными партнеров, полученный из функции get_partners()
|
||
|
||
Returns:
|
||
None: функция выполняет только вывод в консоль
|
||
|
||
Формат вывода:
|
||
Каждая карточка партнера оформлена в виде рамки с следующими полями:
|
||
- Тип партнера
|
||
- Наименование партнера
|
||
- Директор
|
||
- Рейтинг
|
||
- Общее количество проданных единиц (форматированное с разделителями тысяч)
|
||
- Размер и описание скидки
|
||
- Электронная почта
|
||
- Телефон
|
||
- ИНН
|
||
- Юридический адрес (обрезается до 60 символов если слишком длинный)
|
||
|
||
Особенности:
|
||
- Если передан пустой DataFrame или None, выводится сообщение об отсутствии данных
|
||
- Адрес автоматически обрезается если превышает 60 символов
|
||
- Числовые значения количества форматируются с разделителями тысяч
|
||
- Между карточками добавляются пустые строки для лучшей читаемости
|
||
|
||
Example:
|
||
>>> partners_data = get_partners()
|
||
>>> print_partner_cards(partners_data)
|
||
|
||
╔═══════════════════════════════════════════════════════════════════════╗
|
||
║ КАРТОЧКА ПАРТНЕРА ║
|
||
╠═══════════════════════════════════════════════════════════════════════╣
|
||
║ Тип: Поставщик ║
|
||
║ Наименование: ООО "Ромашка" ║
|
||
║ Директор: Иванов Иван Иванович ║
|
||
║ Рейтинг: 4.8 ║
|
||
║ Продано единиц: 150,000 ║
|
||
║ Скидка: 10% (50000-300000 ед.) ║
|
||
║ ║
|
||
║ Контакты: info@romashka.ru ║
|
||
║ Телефон: +7 (495) 123-45-67 ║
|
||
║ ║
|
||
║ ИНН: 7712345678 ║
|
||
║ Адрес: г. Москва, ул. Ленина, д. 1, офис 25 ║
|
||
╚═══════════════════════════════════════════════════════════════════════╝
|
||
"""
|
||
###5 def print_sales_cards(sales_df):
|
||
"""Выводит историю реализации продукции в виде форматированной таблицы с рамкой
|
||
|
||
Args:
|
||
sales_df (pandas.DataFrame): DataFrame с данными о продажах, полученный из функции get_sales_history()
|
||
|
||
Returns:
|
||
None: функция выполняет только вывод в консоль
|
||
|
||
Формат вывода:
|
||
Таблица с рамкой содержит следующие колонки:
|
||
- Дата: дата продажи (обрезается до 10 символов)
|
||
- Партнер: наименование партнера (максимум 16 символов)
|
||
- Продукция: название продукции (максимум 57 символов)
|
||
- Артикул: артикул продукции (максимум 8 символов)
|
||
- Кол-во: количество проданных единиц (форматируется с разделителями тысяч)
|
||
- Цена: цена за единицу (форматируется с двумя decimal places)
|
||
- Сумма: общая сумма продажи (форматируется с двумя decimal places)
|
||
|
||
Особенности:
|
||
- Если передан пустой DataFrame или None, выводится сообщение об отсутствии данных
|
||
- Все числовые значения форматируются с разделителями тысяч и двумя знаками после запятой
|
||
- В конце таблицы выводятся итоговые показатели:
|
||
* Количество продаж
|
||
* Общее количество проданных единиц
|
||
* Общая сумма всех продаж
|
||
- Ширина таблицы фиксирована (147 символов) для сохранения форматирования
|
||
|
||
Example:
|
||
>>> sales_data = get_sales_history(limit=10)
|
||
>>> print_sales_cards(sales_data)
|
||
|
||
╔═══════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════╗
|
||
║ ИСТОРИЯ РЕАЛИЗАЦИИ ПРОДУКЦИИ ║
|
||
╠═══════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════╣
|
||
║ Дата Партнер Продукция Арт Кол-во Цена Сумма ║
|
||
╠═══════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════╣
|
||
║ 2024-01-15 ║ ООО "Ромашка" ║ Процессор Intel Core i7-13700K ║ A123 ║ 150 ║ 25,000.00 ║ 3,750,000.00 ║
|
||
║ 2024-01-14 ║ ИП Петров ║ Монитор Samsung Odyssey G7 27" ║ B456 ║ 50 ║ 35,000.00 ║ 1,750,000.00 ║
|
||
╚═══════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════╝
|
||
📊 ИТОГО: 2 продаж, 200 единиц, общая сумма: 5,500,000.00 руб.
|
||
"""
|
||
###6 def check_database():
|
||
"""Упрощенная функция выбора опции из списка с валидацией ввода
|
||
|
||
Args:
|
||
options (list): список строк с доступными опциями для выбора
|
||
|
||
Returns:
|
||
str: выбранная опция из списка options
|
||
|
||
Особенности:
|
||
- Выводит пронумерованный список опций в красивом формате
|
||
- Запрашивает ввод пользователя с валидацией
|
||
- Обрабатывает некорректный ввод и повторяет запрос
|
||
- Обрабатывает прерывание программы (Ctrl+C) с graceful shutdown
|
||
- Поддерживает ввод только цифровых значений в допустимом диапазоне
|
||
|
||
Raises:
|
||
SystemExit: при прерывании программы пользователем (KeyboardInterrupt)
|
||
|
||
Example:
|
||
>>> options = ["Показать всех партнеров", "История продаж", "Выход"]
|
||
>>> choice = simple_choice(options)
|
||
|
||
==================================================
|
||
ВЫБЕРИТЕ ОПЦИЮ:
|
||
==================================================
|
||
1. Показать всех партнеров
|
||
2. История продаж
|
||
3. Выход
|
||
|
||
Введите номер (1-3): 2
|
||
>>> print(choice)
|
||
"История продаж"
|
||
|
||
Обработка ошибок:
|
||
- Некорректный ввод (не цифры): повторный запрос
|
||
- Число вне диапазона: повторный запрос
|
||
- Прерывание (Ctrl+C): graceful exit программы
|
||
- EOF (Ctrl+D в Unix): обрабатывается как некорректный ввод
|
||
"""
|
||
"""Проверяет загруженные данные в базе данных и выводит статистику по таблицам
|
||
|
||
Функция подключается к SQLite базе данных и подсчитывает количество записей
|
||
в каждой из основных таблиц системы для проверки целостности данных.
|
||
|
||
Args:
|
||
None: использует фиксированный путь к базе данных 'partners.db'
|
||
|
||
Returns:
|
||
None: функция выполняет только вывод статистики в консоль
|
||
|
||
Проверяемые таблицы:
|
||
- PartnerType: типы партнеров (поставщики, клиенты и т.д.)
|
||
- Partner: основные данные о партнерах
|
||
- ProductType: категории продукции
|
||
- Product: данные о продукции
|
||
- Sale: история продаж
|
||
|
||
Особенности:
|
||
- Автоматически закрывает соединение с базой данных используя try-finally
|
||
- Выводит результаты в читаемом формате с эмодзи для наглядности
|
||
- Не обрабатывает ошибки явно - предполагается что база данных существует
|
||
и доступна для чтения
|
||
|
||
Example:
|
||
>>> check_database()
|
||
|
||
🔍 Проверка загруженных данных:
|
||
PartnerType: 3 записей
|
||
Partner: 15 записей
|
||
ProductType: 5 записей
|
||
Product: 25 записей
|
||
Sale: 150 записей
|
||
|
||
Note:
|
||
Для работы функции требуется существование файла 'partners.db' и всех
|
||
указанных таблиц в базе данных. В случае отсутствия таблиц может
|
||
возникнуть исключение sqlite3.OperationalError.
|
||
"""
|
||
###7 def load_data_from_files():
|
||
"""Загружает данные из Excel файлов в базу данных SQLite
|
||
|
||
Функция выполняет полную загрузку данных из четырех Excel файлов в соответствующие таблицы базы данных.
|
||
Процесс загрузки состоит из пяти этапов, выполняемых последовательно с проверкой целостности данных.
|
||
|
||
Args:
|
||
None: имена файлов запрашиваются у пользователя через интерактивный ввод
|
||
|
||
Returns:
|
||
None: функция выполняет операции с базой данных и выводит результаты в консоль
|
||
|
||
Процесс загрузки:
|
||
1. 📊 Типы партнеров - из файла партнеров извлекаются уникальные типы
|
||
2. 👥 Партнеры - загрузка основных данных о партнерах с привязкой к типам
|
||
3. 📦 Типы продукции - загрузка категорий продукции с коэффициентами
|
||
4. 🏷️ Продукты - загрузка данных о продукции с привязкой к типам
|
||
5. 💰 Продажи - загрузка истории продаж с валидацией связей и преобразованием дат
|
||
|
||
Требуемые файлы:
|
||
- Файл с партнерами: содержит данные о партнерах и их типах
|
||
- Файл с типами продукции: содержит категории продукции и коэффициенты
|
||
- Файл с продуктами: содержит данные о продукции с привязкой к типам
|
||
- Файл с продажами: содержит историю продаж с ссылками на партнеров и продукты
|
||
|
||
Особенности:
|
||
- Использует INSERT OR IGNORE для избежания дублирования записей
|
||
- Выполняет проверку существования связанных записей перед вставкой продаж
|
||
- Преобразует даты в стандартный SQL формат (YYYY-MM-DD)
|
||
- Автоматически рассчитывает цену продажи на основе минимальной партнерской цены
|
||
- В случае ошибки выполняет откат транзакции (rollback)
|
||
- После успешной загрузки вызывает check_database() для отображения статистики
|
||
|
||
Обработка ошибок:
|
||
- Отлавливает и выводит подробные сообщения об ошибках
|
||
- Продолжает загрузку при отсутствии некоторых продуктов/партнеров с предупреждениями
|
||
- Подсчитывает и выводит количество успешно загруженных продаж
|
||
|
||
Example:
|
||
>>> load_data_from_files()
|
||
|
||
📁 Введите имена файлов:
|
||
Файл с партнерами: partners.xlsx
|
||
Файл с типами продукции: product_types.xlsx
|
||
Файл с продуктами: products.xlsx
|
||
Файл с продажами: sales.xlsx
|
||
|
||
1. 📊 Загрузка типов партнеров...
|
||
2. 👥 Загрузка партнеров...
|
||
3. 📦 Загрузка типов продукции...
|
||
4. 🏷️ Загрузка продуктов...
|
||
5. 💰 Загрузка продаж...
|
||
✅ Данные успешно загружены! Загружено 150 продаж
|
||
|
||
Note:
|
||
Для работы функции требуются файлы в формате Excel (.xlsx) с определенной структурой колонок,
|
||
соответствующих ожидаемым названиям в коде.
|
||
"""
|
||
###8 def display_menu():
|
||
"""Главное меню программы для управления базой данных партнеров и продаж
|
||
|
||
Функция предоставляет интерактивный интерфейс для работы с системой управления партнерами.
|
||
Реализует основной цикл программы с возможностью выбора различных операций.
|
||
|
||
Args:
|
||
None: все параметры задаются внутри функции или запрашиваются у пользователя
|
||
|
||
Returns:
|
||
None: функция выполняется до выбора опции выхода
|
||
|
||
Основные функции меню:
|
||
1. КАРТОЧКИ ПАРТНЕРОВ (сортировка по рейтингу) - отображение партнеров, отсортированных по рейтингу
|
||
2. КАРТОЧКИ ПАРТНЕРОВ (сортировка по скидкам) - отображение партнеров, отсортированных по уровню скидки
|
||
3. ИСТОРИЯ РЕАЛИЗАЦИИ - просмотр последних 50 записей о продажах
|
||
4. ЗАПОЛНЕНИЕ БД из файлов - полная переинициализация базы данных с загрузкой из Excel файлов
|
||
5. ВЫХОД - завершение работы программы
|
||
|
||
Особенности работы:
|
||
- Использует simple_choice() для интерактивного выбора опций
|
||
- Бесконечный цикл до выбора опции выхода
|
||
- При выборе загрузки данных удаляет существующую базу и создает новую
|
||
- Автоматически создает необходимые таблицы при инициализации базы
|
||
- Обеспечивает единообразное форматирование вывода для всех опций
|
||
|
||
Flow программы:
|
||
while True:
|
||
Показать меню опций
|
||
Получить выбор пользователя
|
||
Выполнить соответствующую функцию
|
||
Если выбран ВЫХОД - прервать цикл
|
||
|
||
Example:
|
||
==================================================
|
||
ВЫБЕРИТЕ ОПЦИЮ:
|
||
==================================================
|
||
1. КАРТОЧКИ ПАРТНЕРОВ (сортировка по рейтингу)
|
||
2. КАРТОЧКИ ПАРТНЕРОВ (сортировка по скидкам)
|
||
3. ИСТОРИЯ РЕАЛИЗАЦИИ
|
||
4. ЗАПОЛНЕНИЕ БД из файлов
|
||
5. ВЫХОД
|
||
|
||
Введите номер (1-5): 1
|
||
|
||
🎯 КАРТОЧКИ ПАРТНЕРОВ (сортировка по рейтингу)
|
||
══════════════════════════════════════════════════════════════════════
|
||
[вывод карточек партнеров...]
|
||
|
||
Dependencies:
|
||
- simple_choice(): для выбора опций меню
|
||
- get_partners(): для получения данных партнеров
|
||
- print_partner_cards(): для форматированного вывода партнеров
|
||
- get_sales_history(): для получения истории продаж
|
||
- print_sales_cards(): для форматированного вывода продаж
|
||
- create_tables(): для создания структуры базы данных
|
||
- load_data_from_files(): для загрузки данных из файлов
|
||
""" |