Схема базы данных

Обзор

База данных Wepps использует MySQL/MariaDB с кодировкой utf8mb4 для полной поддержки Unicode.

Таблицы делятся на две категории:

• Системные (префикс s_) - управляют структурой и конфигурацией
• Контентные (без префикса) - хранят данные сайта

Системные таблицы

s_Navigator

Основная таблица навигации и структуры сайта.

Связи:

• ParentDir → s_Navigator.Id (иерархия разделов)
• Extension → s_Extensions.Id (привязка функционала)

Примечание: Управление разделами осуществляется через админку в разделе «Навигация».

---

s_Extensions

Зарегистрированные расширения для разделов сайта.

Создание нового расширения:

1. Создается запись в s_Extensions через админку
2. Автоматически создается папка WeppsExtensions/{Name}/
3. Привязывается к разделу через s_Navigator.Extension

---

s_ConfigExtensions

Системные расширения для административной панели.

Примечание: Системные расширения создаются через админку в списке «Системные расширения».

Расположение: WeppsAdmin/ConfigExtensions/{Name}/

---

s_Config

Конфигурация таблиц данных для админки.

Создание таблицы: При добавлении записи в s_Config через админку (раздел «Списки данных») автоматически:

1. Создается новая таблица в БД с базовой структурой
2. Устанавливаются стандартные индексы (PRIMARY KEY, Priority, IsActive и др.)
3. Настраивается utf8mb4 кодировка

---

s_ConfigFields

Настройки полей таблиц для автогенерации форм в админке.

Примечание: Поля можно создавать через системное расширение "Загрузки из Excel" в админке.

Типы полей:

• text - текстовое поле
• textarea - многострочный текст
• wysiwyg - визуальный редактор
• select - выпадающий список
• checkbox - чекбокс
• file - загрузка файлов
• date - дата
• number - числовое поле

---

s_Permissions

Права доступа для пользователей в административной панели.

Стандартные уровни:

• 1 - Администратор (полный доступ ко всем таблицам и системным расширениям)
• 2 - Редактор (ограниченный доступ к контентным таблицам)
• 3 - Посетитель сайта (нет доступа в админку)

Примечание: Управление уровнями прав осуществляется через админку в списке "Права доступа".

---

s_Users

Пользователи системы.

Связи:

• UserPermissions → s_Permissions.Id (уровень прав доступа)

Стандартные уровни прав:

• 1 - Администратор (полный доступ ко всем таблицам и системным расширениям)
• 2 - Редактор (ограниченный доступ к контентным таблицам)
• 3 - Посетитель сайта (без доступа в админку)

Примечание: Управление пользователями осуществляется через админку в списке «Пользователи».

---

s_Files

Файловое хранилище (загруженные файлы, изображения).

Связи:

• TableName + TableNameId → связь с любой контентной таблицей

**Структура хранения:

• Оригиналы: /files/lists/{TableName}/
• Превью: /pic/preview/files/{InnerName}
• Средние: /pic/medium/files/{InnerName}

---

Контентные таблицы

Products (Товары)

Связи:

• BrandId → Brands.Id

---

News (Новости)

---

Gallery (Галерея)

---

Contacts (Контакты)

---

Brands (Бренды)

---

Общие паттерны

Стандартные поля

При автоматическом создании таблиц через s_Config создаются базовые поля:

• Id - PRIMARY KEY AUTO_INCREMENT
• Name - название/заголовок
• Alias - алиас для URL или внутреннего использования
• IsActive - флаг активности (0/1)
• Priority - порядок сортировки

Дополнительные поля (такие как Url, Description, CreatedAt и др.) добавляются через s_ConfigFields в зависимости от требований проекта.

Связь с файлами

Файлы привязываются через таблицу s_Files:

-- Получить файлы товара
SELECT * FROM s_Files 
WHERE TableName = 'Products' AND TableNameField='Images' AND TableNameId = 15
ORDER BY Priority;

Мультиязычность

Для реализации мультиязычности в таблицах создаются дополнительные поля:

• TableId (INT) - ID записи на основном языке (связь с оригинальной записью)
• LanguageId (INT) - ID языка из системной таблицы языков

Все языковые версии хранятся в одной таблице. Система автоматически извлекает нужные записи на основе TableId и LanguageId в соответствии с языком, выбранным на frontend.

Создание новых таблиц

Через админку (рекомендуемый способ)

1. Перейти в админку → список s_Config
2. Создать запись с названием таблицы
3. Таблица будет создана автоматически со стандартными полями и индексами
4. Настроить поля через s_ConfigFields

Регистрация таблицы

-- Добавить в список таблиц
INSERT INTO s_Config (TableName, Name, Category, Priority) 
VALUES ('MyTable', 'Моя таблица', 'Контент', 50);

-- Настроить поля
INSERT INTO s_ConfigFields (TableName, Field, Name, Type, Required, Priority) VALUES
('MyTable', 'Name', 'Название', 'text', 1, 1),
('MyTable', 'Description', 'Описание', 'wysiwyg', 0, 2),
('MyTable', 'IsActive', 'Активно', 'checkbox', 0, 3);

Индексы и оптимизация

Автоматические индексы

При создании таблиц через s_Config автоматически устанавливаются стандартные индексы:

• PRIMARY KEY на поле Id
• INDEX на Priority (для сортировки)
• INDEX на IsActive (для фильтрации)

Дополнительные индексы

Добавлять кастомные индексы следует в соответствии с требованиями конкретного приложения:

-- Пример: индекс для связи с другой таблицей
CREATE INDEX idx_brand ON Products(BrandId);

-- Пример: составной индекс для частых запросов
CREATE INDEX idx_active_priority ON Products(IsActive, Priority);

Полнотекстовый поиск

ALTER TABLE Products ADD FULLTEXT idx_search (Name, Description);

-- Использование
SELECT * FROM Products 
WHERE MATCH(Name, Description) AGAINST('поисковый запрос' IN BOOLEAN MODE);

Миграции

При обновлении структуры БД создавайте миграции:

// packages/WeppsAdmin/Updates/migrations/001_add_field.php
Connect::$db->exec("ALTER TABLE Products ADD COLUMN NewField VARCHAR(255)");

Дополнительные материалы

• Архитектура платформы
• Разработка расширений