init

README.md

@@ -1,2 +1,63 @@
 ### Проектирование схемы БД
 
+Поставленную задачу можно решить 3 основными подходами: Closure Table, Nested Sets, Adjacency List.
+
+Я выбрал Closure Table (таблица замыканий), так как он обеспечивает простые и
+быстрые запросы к поддеревьям категорий независимо от глубины вложенности. 
+В любом запросе к дереву я могу обойтись обычным JOIN по таблице связей
+category_closure, без рекурсивных CTE и сложной логики в SQL. Это даёт 
+предсказуемую производительность на больших иерархиях и хорошо масштабируется
+при росте количества уровней и категорий. Дополнительно, Closure Table 
+позволяет так же просто получать не только потомков, но и всех предков 
+узла (например, для хлебных крошек) через тот же механизм. Структура 
+данных при этом остаётся реляционной и хорошо индексируемой: по предку 
+`ancestor_id` и по потомку `descendant_id`. Операции изменения структуры 
+(добавление, перемещение, удаление узлов) сложнее, чем при простом `parent_id`, 
+но их можно инкапсулировать в функции/процедуры и вызывать как единый API. 
+В реальном каталоге товаров такие изменения происходят значительно реже, чем 
+чтение каталога и выборка товаров по разделам, поэтому увеличение стоимости 
+изменений логично обменять на ускорение чтения. 
+
+Таким образом, Closure Table лучше всего соответствует требованиям: 
+- произвольная глубина дерева, 
+- быстрый доступ к поддеревьям
+- приемлемая стоимость редких операций изменения структуры категорий.
+
+---
+#### Диаграмма БД
+<img src="https://storage.ooru.ru/web/db_design/schema.jpg" width="700" alt="Схема базы данных" />
+
+---
+
+### Примеры данных в таблицах
+
+#### Покупатели
+
+<img src="https://storage.ooru.ru/web/db_design/client.jpg" width="450" alt="Таблица покупателей" />
+
+---
+
+#### Заказы
+<img src="https://storage.ooru.ru/web/db_design/customer_order.jpg" width="500" alt="Таблица заказов" />
+
+---
+
+#### Позиции заказа
+<img src="https://storage.ooru.ru/web/db_design/customer_order_item.jpg" width="480" alt="Таблица позиций заказа" />
+
+---
+
+#### Номенклатура (товары)
+<img src="https://storage.ooru.ru/web/db_design/product.jpg" width="500" alt="Таблица товаров" />
+
+---
+
+#### Категории
+<img src="https://storage.ooru.ru/web/db_design/category.jpg" width="400" alt="Таблица категорий" />
+
+---
+
+#### Closure Table для категорий
+<img src="https://storage.ooru.ru/web/db_design/category_closure.jpg" width="400" alt="Closure Table категорий" />
+
+---

schemas/core.sql

@@ -0,0 +1,131 @@
+
+CREATE SCHEMA IF NOT EXISTS shop;
+
+------------------------------------------------------------
+-- 1. Таблицы-справочники и основные сущности
+------------------------------------------------------------
+
+-- 1.1. Клиенты
+CREATE TABLE shop.client (
+    id      BIGSERIAL PRIMARY KEY,
+    name    TEXT NOT NULL,
+    address TEXT
+);
+
+COMMENT ON TABLE shop.client IS 'Таблица клиентов магазина';
+
+COMMENT ON COLUMN shop.client.id        IS 'Уникальный идентификатор клиента';
+COMMENT ON COLUMN shop.client.name      IS 'Имя или наименование клиента';
+COMMENT ON COLUMN shop.client.address   IS 'Адрес клиента';
+
+------------------------------------------------------------
+-- 1.2. Категории (основная таблица)
+------------------------------------------------------------
+
+CREATE TABLE shop.category (
+    id        BIGSERIAL PRIMARY KEY,
+    parent_id BIGINT REFERENCES shop.category(id) ON DELETE SET NULL,
+    name      TEXT NOT NULL
+);
+
+CREATE INDEX idx_category_parent_id ON shop.category(parent_id);
+
+COMMENT ON TABLE shop.category IS 'Таблица категорий товаров (иерархическая структура)';
+
+COMMENT ON COLUMN shop.category.id              IS 'Уникальный идентификатор категории';
+COMMENT ON COLUMN shop.category.parent_id       IS 'Ссылка на родительскую категорию (NULL для корневых категорий)';
+COMMENT ON COLUMN shop.category.name            IS 'Наименование категории';
+
+------------------------------------------------------------
+-- 1.3. Closure Table для категорий
+------------------------------------------------------------
+
+CREATE TABLE shop.category_closure (
+    ancestor_id   BIGINT NOT NULL REFERENCES shop.category(id) ON DELETE CASCADE,
+    descendant_id BIGINT NOT NULL REFERENCES shop.category(id) ON DELETE CASCADE,
+    depth         INT    NOT NULL,
+    PRIMARY KEY (ancestor_id, descendant_id)
+);
+
+-- Быстрый поиск всех потомков (по предку)
+CREATE INDEX idx_category_closure_ancestor_depth
+    ON shop.category_closure (ancestor_id, depth);
+
+-- Быстрый поиск всех предков (по потомку)
+CREATE INDEX idx_category_closure_descendant_depth
+    ON shop.category_closure (descendant_id, depth);
+
+COMMENT ON TABLE shop.category_closure  IS 'Closure Table для эффективной работы с иерархией категорий';
+
+COMMENT ON COLUMN shop.category_closure.ancestor_id     IS 'ID категории-предка в иерархии';
+COMMENT ON COLUMN shop.category_closure.descendant_id   IS 'ID категории-потомка в иерархии';
+COMMENT ON COLUMN shop.category_closure.depth           IS 'Глубина связи: 0 - сам себе предок, 1 - прямой потомок, 2+ - непрямой потомок';
+
+------------------------------------------------------------
+-- 1.4. Номенклатура (товары)
+------------------------------------------------------------
+
+CREATE TABLE shop.product (
+    id          BIGSERIAL PRIMARY KEY,
+    category_id BIGINT NOT NULL REFERENCES shop.category(id) ON DELETE RESTRICT,
+    name        TEXT NOT NULL,
+    quantity    NUMERIC(18,3) NOT NULL DEFAULT 0,
+    price       NUMERIC(18,2) NOT NULL
+);
+
+CREATE INDEX idx_product_category_id ON shop.product(category_id);
+
+COMMENT ON TABLE shop.product IS 'Таблица товаров (номенклатура)';
+
+COMMENT ON COLUMN shop.product.id           IS 'Уникальный идентификатор товара';
+COMMENT ON COLUMN shop.product.category_id  IS 'Ссылка на категорию товара';
+COMMENT ON COLUMN shop.product.name         IS 'Наименование товара';
+COMMENT ON COLUMN shop.product.quantity     IS 'Количество товара на складе';
+COMMENT ON COLUMN shop.product.price        IS 'Цена товара';
+
+
+------------------------------------------------------------
+-- 1.5. Заказы
+------------------------------------------------------------
+
+CREATE TABLE shop.customer_order (
+    id         BIGSERIAL PRIMARY KEY,
+    client_id  BIGINT NOT NULL REFERENCES shop.client(id) ON DELETE RESTRICT,
+    order_date TIMESTAMP NOT NULL DEFAULT NOW(),
+    status     TEXT NOT NULL DEFAULT 'NEW'
+);
+
+CREATE INDEX idx_customer_order_client_id ON shop.customer_order(client_id);
+CREATE INDEX idx_customer_order_order_date ON shop.customer_order(order_date);
+
+COMMENT ON TABLE shop.customer_order IS 'Таблица заказов клиентов';
+
+COMMENT ON COLUMN shop.customer_order.id            IS 'Уникальный идентификатор заказа';
+COMMENT ON COLUMN shop.customer_order.client_id     IS 'Ссылка на клиента, сделавшего заказ';
+COMMENT ON COLUMN shop.customer_order.order_date    IS 'Дата и время создания заказа (по умолчанию - текущее время)';
+COMMENT ON COLUMN shop.customer_order.status        IS 'Статус заказа: NEW - новый, и другие возможные статусы';
+
+------------------------------------------------------------
+-- 1.6. Позиции заказа
+------------------------------------------------------------
+
+CREATE TABLE shop.customer_order_item (
+    id            BIGSERIAL PRIMARY KEY,
+    order_id      BIGINT NOT NULL REFERENCES shop.customer_order(id) ON DELETE CASCADE,
+    product_id    BIGINT NOT NULL REFERENCES shop.product(id) ON DELETE RESTRICT,
+    quantity      NUMERIC(18,3) NOT NULL,
+    price_at_time NUMERIC(18,2) NOT NULL,
+    -- один товар одна позиция в заказе
+    UNIQUE (order_id, product_id)
+);
+
+CREATE INDEX idx_order_item_order_id   ON shop.customer_order_item(order_id);
+CREATE INDEX idx_order_item_product_id ON shop.customer_order_item(product_id);
+
+COMMENT ON TABLE shop.customer_order_item   IS 'Таблица позиций (состав) заказов';
+
+COMMENT ON COLUMN shop.customer_order_item.id               IS 'Уникальный идентификатор позиции в заказе';
+COMMENT ON COLUMN shop.customer_order_item.order_id         IS 'Ссылка на заказ, к которому относится позиция';
+COMMENT ON COLUMN shop.customer_order_item.product_id       IS 'Ссылка на товар в позиции заказа';
+COMMENT ON COLUMN shop.customer_order_item.quantity         IS 'Количество товара в позиции';
+COMMENT ON COLUMN shop.customer_order_item.price_at_time    IS 'Цена товара на момент создания заказа (фиксируется при оформлении)';