minor

db/tables/brands.md

@@ -0,0 +1,5 @@
+# brands
+
+- Справочник брендов.
+- `name` и `slug` уникальны.
+- Используется связью `products.brand_id`.

db/tables/categories.md

@@ -0,0 +1,6 @@
+# categories
+
+- Хранит дерево категорий каталога.
+- `parent_id` ссылается на родительскую категорию.
+- `slug` уникальный, используется в URL и фильтрах.
+- `is_active` позволяет отключать категорию без удаления.

db/tables/prices.md

@@ -0,0 +1,5 @@
+# prices
+
+- Текущая цена товара.
+- `currency` — код ISO 4217 (например, RUB).
+- `old_price` опционально хранит цену до скидки.

db/tables/product_attributes.md

@@ -0,0 +1,5 @@
+# product_attributes
+
+- EAV-таблица характеристик товара.
+- Хранит пары `key/value` и опциональную единицу `unit`.
+- Поддерживает фильтрацию каталога по атрибутам.

db/tables/product_images.md

@@ -0,0 +1,5 @@
+# product_images
+
+- Список изображений товара.
+- `sort_order` определяет порядок показа.
+- Внешний ключ на `products` с каскадным удалением.

db/tables/products.md

@@ -0,0 +1,7 @@
+# products
+
+- Основная таблица товаров.
+- Хранит SKU, описание, ссылки на категорию и бренд.
+- `unit` задан enum `product_unit`.
+- `is_active` используется для мягкого удаления.
+- `created_at` и `updated_at` ведут аудит изменений.

db/tables/stocks.md

@@ -0,0 +1,5 @@
+# stocks
+
+- Остатки по товарам.
+- `qty` — общее количество, `reserved_qty` — зарезервированное.
+- Доступный остаток считается как `qty - reserved_qty`.