Alisa
177 lines
6.5 KiB
Markdown
177 lines
6.5 KiB
Markdown
# Шаг 2. База данных и связи
|
|
|
|
## Что сделано
|
|
|
|
Создана SQL-схема `database/schema.sql` для MariaDB/MySQL и стартовые данные `database/seed.sql`.
|
|
|
|
Также создана локальная страница установки `public/install.php`.
|
|
|
|
Она применяет:
|
|
|
|
- `database/schema.sql`;
|
|
- `database/seed.sql`.
|
|
|
|
Важно: установка пересоздает таблицы, поэтому использовать ее только на старте или в локальной разработке.
|
|
|
|
Схема покрывает основные части проекта:
|
|
|
|
- администраторы;
|
|
- категории и подкатегории;
|
|
- товары;
|
|
- фасовки и цены;
|
|
- изображения товаров;
|
|
- поисковые термины;
|
|
- промокоды и их привязки;
|
|
- расчеты доставки;
|
|
- заказы и позиции заказов;
|
|
- история статусов заказа;
|
|
- вход клиента по email-коду;
|
|
- отзывы;
|
|
- акции;
|
|
- популярные товары;
|
|
- настройки сайта;
|
|
- праздничные/нерабочие дни.
|
|
- старые URL и 301-редиректы для сохранения индексации.
|
|
|
|
## Главная логика связей
|
|
|
|
### Категории
|
|
|
|
Таблица `categories` поддерживает вложенность через `parent_id`.
|
|
|
|
Это позволяет хранить:
|
|
|
|
- главные категории;
|
|
- подкатегории;
|
|
- меню каталога;
|
|
- SEO-текст для страниц категорий.
|
|
|
|
Для переноса со старого сайта у категорий есть поле `legacy_path`. Если старый URL отличается от нового slug, старый путь нужно сохранить и добавить 301-редирект в таблицу `redirects`.
|
|
|
|
Для SEO у категорий есть поля `h1`, `seo_title`, `seo_description`, `seo_keywords`.
|
|
|
|
### Товары
|
|
|
|
Таблица `products` хранит основную карточку товара:
|
|
|
|
- название;
|
|
- slug;
|
|
- категорию;
|
|
- описание;
|
|
- основное фото;
|
|
- базовую единицу;
|
|
- режим отображения цены;
|
|
- публикацию;
|
|
- доступность;
|
|
- признаки "новинка", "хит", "акция".
|
|
|
|
Для товаров также есть поле `legacy_path`, чтобы переносить старые ссылки без потери индексации.
|
|
|
|
Для SEO у товаров есть поля `h1`, `seo_title`, `seo_description`, `seo_keywords`.
|
|
|
|
### Фасовки
|
|
|
|
Таблица `product_variants` хранит отдельные фасовки товара.
|
|
|
|
Именно фасовка попадает в корзину, а не просто товар.
|
|
|
|
Пример:
|
|
|
|
- товар: горбуша неразделанная;
|
|
- фасовка: пласт 10 кг;
|
|
- `package_quantity`: 10;
|
|
- `step_quantity`: 10;
|
|
- `price_per_unit`: 600;
|
|
- `package_price`: 6000.
|
|
|
|
Так можно корректно сделать плюс/минус кратно фасовке.
|
|
|
|
### Заказы
|
|
|
|
Таблица `orders` хранит заказ целиком:
|
|
|
|
- имя;
|
|
- телефон;
|
|
- email;
|
|
- тип получения;
|
|
- адрес;
|
|
- суммы;
|
|
- промокод;
|
|
- расчет доставки;
|
|
- статус.
|
|
|
|
Таблица `order_items` хранит снимок каждой позиции заказа.
|
|
|
|
Снимок нужен, чтобы старые заказы не менялись при изменении цены или названия товара в каталоге.
|
|
|
|
### Промокоды
|
|
|
|
Таблица `promocodes` хранит сам промокод.
|
|
|
|
Таблица `promocode_targets` хранит ограничения:
|
|
|
|
- на категорию;
|
|
- на товар.
|
|
|
|
Если промокод действует на весь заказ, targets не нужны.
|
|
|
|
Для отображения выгодных цен в каталоге у промокодов есть поля:
|
|
|
|
- `show_in_price_tiers` - показывать как градацию цены;
|
|
- `price_tier_label` - подпись для карточки товара.
|
|
|
|
Так можно показывать покупателю базовую цену, цену от 20 000 руб. наличными и цену от 50 000 руб. наличными.
|
|
|
|
### Доставка
|
|
|
|
Таблица `delivery_calculations` хранит результат расчета:
|
|
|
|
- тип доставки;
|
|
- адрес;
|
|
- сумма заказа;
|
|
- расстояние от МКАД;
|
|
- порог бесплатной доставки;
|
|
- стоимость доставки;
|
|
- стоимость подъема;
|
|
- объяснение расчета.
|
|
|
|
Это нужно, чтобы в заказе сохранялся расчет, который видел клиент.
|
|
|
|
### История заказов по email
|
|
|
|
Таблица `customer_login_codes` хранит одноразовые коды входа по email.
|
|
|
|
SMS не используются.
|
|
|
|
### Настройки
|
|
|
|
Таблица `site_settings` хранит настройки сайта:
|
|
|
|
- телефон;
|
|
- email администратора;
|
|
- правила доставки;
|
|
- температуры камер;
|
|
- тексты и числовые параметры.
|
|
|
|
## Как применить схему
|
|
|
|
1. Открыть в браузере `/install.php?token=rybstock-local-install`.
|
|
2. Нажать кнопку "Создать таблицы и стартовые данные".
|
|
3. После успешной установки база будет содержать таблицы проекта и стартовые категории/настройки.
|
|
|
|
Страница работает только при `APP_ENV=local` и правильном `INSTALL_TOKEN` из `.env`.
|
|
|
|
## Что нужно сделать следующим шагом
|
|
|
|
Шаг 3:
|
|
|
|
1. Создать базовые PHP-классы для работы с таблицами:
|
|
- `CategoryRepository`;
|
|
- `ProductRepository`;
|
|
- `ProductVariantRepository`;
|
|
- `OrderRepository`;
|
|
- `PromocodeRepository`;
|
|
- `SettingRepository`.
|
|
2. Сделать первый вывод категорий на главной странице.
|
|
3. Подготовить основу админки: вход администратора и список разделов.
|