python-simpletables 0.1.30__py3-none-any.whl → 0.2.1__py3-none-any.whl

python_simpletables/__main__.md.py

@@ -0,0 +1,124 @@
+# Проектная документация  
+## Информационная система управления заказами, производством и спецификациями
+
+### 1. Введение  
+Настоящая документация описывает функциональное назначение и методы реализации информационной системы (ИС) для управления деятельностью предприятия, выпускающего продукцию по спецификациям. Система обеспечивает ведение справочников заказчиков, товаров, заказов, производственных партий, спецификаций, а также авторизацию пользователей с разграничением прав доступа. Разработка выполнена в рамках демонстрационного экзамена по специальности 09.02.07 «Информационные системы и программирование» (базовый уровень).
+
+### 2. Функциональное назначение  
+ИС предназначена для автоматизации следующих бизнес-процессов:
+
+- Хранение и редактирование данных о заказчиках (покупателях и продавцах);
+- Учёт товаров (продукции) с ценой за единицу и единицами измерения;
+- Оформление заказов с указанием исполнителя, заказчика и даты;
+- Формирование позиций заказов (товар, количество);
+- Учёт производственных партий (дата производства);
+- Составление материальных и продуктовых спецификаций на производство;
+- Расчёт полной стоимости заказа на основе себестоимости материалов;
+- Разграничение доступа через авторизацию с ролями «Администратор» и «Пользователь»;
+- Защита от несанкционированного доступа с помощью интерактивной капчи (пазл) и блокировки учётной записи после трёх неудачных попыток.
+
+### 3. Архитектура и используемые методы
+
+#### 3.1. Общая архитектура  
+Приложение построено по модели **клиент-сервер** на уровне локального подключения: графический интерфейс (Tkinter) взаимодействует с файлом базы данных SQLite. Вся логика управления данными инкапсулирована в классах `Table` и `TableUsers` (наследник). Модуль `__main__.py` содержит главное окно приложения и реализацию всех пользовательских сценариев.
+
+#### 3.2. Работа с базой данных  
+- Используется **SQLite3** как встроенная СУБД. Файл базы данных `__main__.db` создаётся при первом запуске.
+- Инициализация схемы выполняется скриптом `__main__.sql` (создание всех таблиц, включение внешних ключей).
+- Дополнительно создаётся таблица `Users` для хранения учётных записей (логин, пароль, роль, флаг блокировки, счётчик попыток).
+- Все операции с БД выполняются через методы класса `Table`, обеспечивающие CRUD (создание, чтение, обновление, удаление) с проверкой целостности и пользовательскими валидаторами.
+
+**Методы класса `Table` (основные):**  
+- `data_create(row)` – вставка новой записи;  
+- `data_set(key, row)` – обновление записи по первичному ключу;  
+- `data_delete(key)` – удаление записи;  
+- `data_get(primary_value)` – выборка записи по ключу;  
+- `data_readall()` – чтение всех записей;  
+- `conn_execute(cmd, args)` – выполнение SQL-запроса с обработкой ошибок.
+
+**Параметры:**  
+- `row` – список или словарь значений полей;  
+- `key` – значение первичного ключа.
+
+#### 3.3. Визуальный интерфейс и управление таблицами  
+- Для каждой таблицы создаётся вкладка (кнопка-переключатель) в верхней части окна.
+- Данные отображаются в виджете `ttk.Treeview`, колонки настраиваются через объекты `Field`.
+- Каждая таблица снабжена кнопками: **Создать**, **Изменить**, **Удалить**, **Экспорт в JSON/Excel**, **Импорт из JSON/Excel**.
+- Для полей задаются функции отображения (`show`) и ввода (`ask`), что позволяет кастомизировать представление (например, пароль скрывается звёздочками, булевы значения показываются как «Да/Нет»).
+
+**Класс `Field`** содержит атрибуты:  
+- `name` – имя поля в БД;  
+- `title` – заголовок в интерфейсе;  
+- `show` – функция преобразования значения в строку;  
+- `ask` – функция вызова диалога для ввода/редактирования;  
+- `ref` – ссылка на другую таблицу для поддержки внешних ключей.
+
+#### 3.4. Авторизация и капча-пазл  
+- При запуске приложения появляется окно `LoginWindow` с полями ввода логина и пароля.
+- Капча представляет собой пазл из 4 фрагментов исходного изображения (файлы 1.png … 4.png в папке `__main__`). Фрагменты перемешиваются случайным образом; пользователь должен кликать на два фрагмента для их обмена, чтобы восстановить правильный порядок.
+- После каждой неудачной попытки (неверный пароль или неправильно собранный пазл) счётчик `attempts` увеличивается. При достижении 3 – запись блокируется (`is_blocked = 1`).
+- При успешной авторизации счётчик сбрасывается, пользователь получает сообщение и переходит в главное окно.
+
+**Методы:**  
+- `try_login()` – проверка логина/пароля, сборки пазла и блокировки;  
+- `draw_puzzle()` – отрисовка фрагментов на Canvas;  
+- `on_piece_click()` – обработка обмена фрагментов;  
+- Проверка сборки: `self.current_order == list(range(4))`.
+
+#### 3.5. Расчёт стоимости заказа  
+- Для заказа, выбранного в таблице «Заказы», по кнопке **Рассчитать стоимость** запускается диалог `CalcPriceDialog`.
+- SQL-запрос (сложный `LEFT JOIN`) собирает позиции заказа, для каждой позиции ищет соответствующую спецификацию (если есть), затем для каждого материала спецификации вычисляет долю стоимости в расчёте на единицу продукции.
+- Итоговая стоимость вычисляется как сумма по всем позициям:  
+  `price_piece = COALESCE( op.amount * gm.price_for_unit * sm.amount / s.amount, op.amount * g.price_for_unit )`
+- Результат отображается в табличном виде с детализацией по ингредиентам и общей суммой.
+
+**Параметры запроса:**  
+- `order_id` – идентификатор заказа (передаётся либо из выделенной строки, либо через аргумент).
+
+#### 3.6. Импорт/экспорт данных  
+- Поддерживаются форматы **JSON** и **Excel** (через библиотеку `pandas`).
+- При импорте выполняется проверка корректности каждой записи методом `is_valid(row)`. В случае Excel первая встреченная некорректная строка считается концом данных.
+- Экспорт выгружает все поля текущей таблицы.
+
+**Методы:**  
+- `export_json(file)` – сериализует все записи в JSON;  
+- `import_json(file)` – десериализует и добавляет записи;  
+- `export_excel(file)` – создаёт DataFrame и сохраняет в Excel;  
+- `import_excel(file)` – читает Excel, преобразует типы (`fromnp`) и добавляет записи.
+
+#### 3.7. Ролевая модель и управление пользователями  
+- В таблице `Users` хранятся поля: `id`, `login`, `password`, `role` ('admin' или 'user'), `is_blocked`, `attempts`.
+- При входе определяется роль, и для администратора отображается вкладка «Пользователи» с возможностью создавать, редактировать и разблокировать учётные записи.
+- Класс `TableUsers` переопределяет методы `data_create` и `data_set` для проверки уникальности логина.
+
+### 4. Структура базы данных  
+Схема БД включает следующие таблицы (все с первичным ключом `id` AUTOINCREMENT):
+
+| Таблица | Назначение | Внешние ключи |
+|---------|------------|---------------|
+| `Customers` | Заказчики (ФИО, ИНН, адрес, телефон, флаги продавца/покупателя) | – |
+| `Goods` | Товары (наименование, цена за единицу, единица измерения) | – |
+| `Orders` | Заказы (исполнитель, заказчик, дата) | `executor` → `Customers.id`, `customer` → `Customers.id` |
+| `OrderPositions` | Позиции заказа (заказ, продукт, количество) | `order_id` → `Orders.id`, `product` → `Goods.id` |
+| `Productions` | Производственные партии (дата) | – |
+| `ProductionMaterials` | Используемые материалы в производстве | `prod_id` → `Productions.id`, `product` → `Goods.id` |
+| `ProductionProducts` | Выпущенные продукты в производстве | `prod_id` → `Productions.id`, `product` → `Goods.id` |
+| `Specs` | Спецификации (исполнитель, продукт, количество) | `executor` → `Customers.id`, `production` → `Goods.id` |
+| `SpecMaterial` | Материалы спецификации | `spec_id` → `Specs.id`, `product` → `Goods.id` |
+| `Users` | Пользователи (логин, пароль, роль, блокировка, попытки) | – |
+
+Все внешние ключи включены (`PRAGMA foreign_keys = ON`), обеспечивая ссылочную целостность.
+
+### 5. Интерфейс пользователя  
+Главное окно содержит панель вкладок (кнопки) для переключения между таблицами. Каждая вкладка представляет собой фрейм с табличным представлением и панелью управления внизу. Для администратора доступна вкладка «Пользователи» с функциями управления учётными записями.
+
+Окно авторизации содержит поля ввода, кнопку «Войти» и область для сборки пазла (Canvas). При успешном входе выводится информационное сообщение, при ошибках – соответствующие диалоги с предупреждениями.
+
+### 6. Используемые технологии и библиотеки  
+- **Python 3** (стандартная библиотека: `tkinter`, `sqlite3`, `json`, `os`, `random`, `dataclasses`);
+- **Pillow** – для работы с изображениями (загрузка и масштабирование фрагментов пазла);
+- **pandas** – для импорта/экспорта Excel;
+- **numpy** – для преобразования типов данных при импорте.
+
+### 7. Заключение  
+Разработанная информационная система полностью удовлетворяет требованиям технического задания: реализованы все необходимые сущности, поддерживаются CRUD-операции, расчёт стоимости заказа, ролевая модель с блокировкой и капча-пазл. Система готова к использованию в учебных целях и может служить основой для дальнейшей доработки под реальные производственные задачи.

python_simpletables/__main__.sql.py

@@ -0,0 +1,63 @@
+
+PRAGMA foreign_keys = ON;
+CREATE TABLE IF NOT EXISTS "Customers" (
+	id INTEGER PRIMARY KEY AUTOINCREMENT,
+	name TEXT NOT NULL,
+	inn TEXT NOT NULL,
+	addres TEXT NOT NULL,
+	phone TEXT NOT NULL,
+	is_salesman INTEGER NOT NULL,
+	is_buyer INTEGER NOT NULL
+);
+CREATE TABLE IF NOT EXISTS "Goods" (
+	id INTEGER PRIMARY KEY AUTOINCREMENT,
+	name TEXT NOT NULL,
+	price_for_unit REAL NOT NULL,
+	unit TEXT NOT NULL
+);
+CREATE TABLE IF NOT EXISTS "Orders" (
+	id INTEGER PRIMARY KEY AUTOINCREMENT,
+	executor INTEGER NOT NULL REFERENCES "Customers"(id),
+	customer INTEGER NOT NULL REFERENCES "Customers"(id),
+	order_date DATE NOT NULL
+);
+CREATE TABLE IF NOT EXISTS "OrderPositions" (
+	id INTEGER PRIMARY KEY AUTOINCREMENT,
+	order_id INTEGER NOT NULL REFERENCES "Orders"(id),
+	product INTEGER NOT NULL REFERENCES "Goods"(id),
+	amount REAL NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS "Productions" (
+	id INTEGER PRIMARY KEY AUTOINCREMENT,
+	production_date DATE NOT NULL
+);
+CREATE TABLE IF NOT EXISTS "ProductionMaterials" (
+	id INTEGER PRIMARY KEY AUTOINCREMENT,
+	prod_id INTEGER NOT NULL REFERENCES "Productions"(id),
+	product INTEGER NOT NULL REFERENCES "Goods"(id),
+	amount REAL NOT NULL
+);
+CREATE TABLE IF NOT EXISTS "ProductionProducts" (
+	id INTEGER PRIMARY KEY AUTOINCREMENT,
+	prod_id INTEGER NOT NULL REFERENCES "Productions"(id),
+	product INTEGER NOT NULL REFERENCES "Goods"(id),
+	amount REAL NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS "Specs" (
+	id INTEGER PRIMARY KEY AUTOINCREMENT,
+	executor INTEGER NOT NULL REFERENCES "Customers"(id),
+	production INTEGER NOT NULL REFERENCES "Goods"(id),
+	amount REAL NOT NULL
+);
+CREATE TABLE IF NOT EXISTS "SpecMaterial" (
+	id INTEGER PRIMARY KEY AUTOINCREMENT,
+	spec_id INTEGER NOT NULL REFERENCES "Specs"(id),
+	product INTEGER NOT NULL REFERENCES "Goods"(id),
+	amount REAL NOT NULL
+);
+
+
+
+

{python_simpletables-0.1.30.dist-info → python_simpletables-0.2.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python_simpletables
-Version: 0.1.30
+Version: 0.2.1
 Summary: Simple connection between SQL and tkinter.
 Author-email: Захар Васильев <vasilyev.zakhar@gmail.com>
 License: MIT

python_simpletables-0.2.1.dist-info/RECORD

@@ -0,0 +1,13 @@
+python_simpletables/__init__.py,sha256=tT2si4YdJPkxm4gGLVUfI7ORt-VM86_O0bFdgYXMyyo,41
+python_simpletables/__main__(1).py,sha256=PT0xbND81WcqQJJ1DSsDx0_4Zx5fdjHnjmlQPIwSr5c,12412
+python_simpletables/__main__(2).py,sha256=Cdlsbs9ldHw4p9M7l808cmxFduD1ZOgR21JcuII3pNQ,16955
+python_simpletables/__main__.db.py,sha256=gozIUfWG-l-cfZrWP4FyS_Gz1gstmQ568ubcsmxmEDw,53248
+python_simpletables/__main__.md.py,sha256=xsAaxYpJVXYJSgayt2zu3CCFAD--f46wkG1iiJfcciw,14854
+python_simpletables/__main__.png.py,sha256=kBvgQcfrpjXPCtgzX4hOUeexiAH2lOqBbbLP_Lh2cMc,106337
+python_simpletables/__main__.py,sha256=qPboB6kuppJ2m2ySS3pL49ul1Hw2cIQZ404wlwTFKHs,21527
+python_simpletables/__main__.sql.py,sha256=0dTU-8wSbzUfgkzvI7Xr-jBJhKO5Q2mO2LG3WTjHDi4,1876
+python_simpletables/table.py,sha256=jYbZc13m1-4nECcgK94FoVj95ooGfe8HnuAvhXL_26Y,9431
+python_simpletables-0.2.1.dist-info/METADATA,sha256=O6oHbx2nKjUDRLZ0FMUI8xNidTnonHXMMdjLcLPA5KM,227
+python_simpletables-0.2.1.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+python_simpletables-0.2.1.dist-info/top_level.txt,sha256=WhVQcD7ccNKNb-lZhcmTM0kTkcbxh7tE11YiN1ZwE9E,20
+python_simpletables-0.2.1.dist-info/RECORD,,

python_simpletables-0.1.30.dist-info/RECORD

@@ -1,9 +0,0 @@
-python_simpletables/__init__.py,sha256=tT2si4YdJPkxm4gGLVUfI7ORt-VM86_O0bFdgYXMyyo,41
-python_simpletables/__main__(1).py,sha256=PT0xbND81WcqQJJ1DSsDx0_4Zx5fdjHnjmlQPIwSr5c,12412
-python_simpletables/__main__(2).py,sha256=Cdlsbs9ldHw4p9M7l808cmxFduD1ZOgR21JcuII3pNQ,16955
-python_simpletables/__main__.py,sha256=qPboB6kuppJ2m2ySS3pL49ul1Hw2cIQZ404wlwTFKHs,21527
-python_simpletables/table.py,sha256=jYbZc13m1-4nECcgK94FoVj95ooGfe8HnuAvhXL_26Y,9431
-python_simpletables-0.1.30.dist-info/METADATA,sha256=S0RO4wfChI1ROVFzOGUs-Rj--LleFjAfPZlAyikNT6Q,228
-python_simpletables-0.1.30.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-python_simpletables-0.1.30.dist-info/top_level.txt,sha256=WhVQcD7ccNKNb-lZhcmTM0kTkcbxh7tE11YiN1ZwE9E,20
-python_simpletables-0.1.30.dist-info/RECORD,,