From 0a11c9771fb181610b1034e7105fc5150bf033c7 Mon Sep 17 00:00:00 2001 From: user_3d Date: Thu, 6 Nov 2025 09:24:18 +0500 Subject: [PATCH] 20250611 --- main.py | 2 +- read.txt | 382 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 383 insertions(+), 1 deletion(-) diff --git a/main.py b/main.py index b5a9990..bdea55c 100644 --- a/main.py +++ b/main.py @@ -443,4 +443,4 @@ def display_menu(): if __name__ == "__main__": display_menu() -#bhgyh + diff --git a/read.txt b/read.txt index 55e5e68..207865a 100644 --- a/read.txt +++ b/read.txt @@ -388,3 +388,385 @@ def display_menu(): # Главная точка запуска программы if __name__ == "__main__": display_menu() + + +###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(): для загрузки данных из файлов + """ \ No newline at end of file