Локальная база данных модуля содержит 3 взаимосвязанные таблицы, которые полностью обеспечивают логику безопасности, распределения прав, учета дубликатов и ведения тегов.

Эта таблица хранит физические параметры каждого файла и жестко привязывает его к уровням приватности и пространству пользователя.

Позволяет привязывать к одному файлу бесконечное количество поисковых меток (например, к одной фотографии можно добавить теги: «2026», «Отпуск», «Мурманск»). Связана с главной таблицей отношением «один ко многим».

• Правило каскадного удаления: Для поля file_id прописывается связь FOREIGN KEY(file_id) REFERENCES files_catalog(id) ON DELETE CASCADE. Это значит, что если Игорь окончательно очистит файл из Корзины, ядро SQLite автоматически и молча сотрет все теги, привязанные к этому файлу, предотвращая появление мусора в базе.

Нужна для расширения логики приватности. Если уровень доступа файла равен private, но Игорь хочет показать этот конкретный файл только Алисе (не открывая его для всей группы или интернета), эта таблица зафиксирует исключение.

Когда Суперадмин будет впервые активировать модуль файлового менеджера, его controller.php выполнит этот чистый SQL-запрос для создания структуры:

SQL-- 1. Создаем таблицу каталога файлов
CREATE TABLE IF NOT EXISTS files_catalog (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    user_id INTEGER NOT NULL,
    orig_name TEXT NOT NULL,
    server_name TEXT NOT NULL,
    file_type TEXT NOT NULL,
    file_size INTEGER NOT NULL,
    file_hash TEXT NOT NULL,
    virtual_folder TEXT DEFAULT '/',
    access_level TEXT DEFAULT 'private',
    download_count INTEGER DEFAULT 0,
    is_deleted INTEGER DEFAULT 0,
    created_at DATETIME DEFAULT CURRENT_TIMESTAMP
);
 
-- 2. Создаем таблицу тегов с автоматической очисткой
CREATE TABLE IF NOT EXISTS files_tags (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    file_id INTEGER NOT NULL,
    tag_name TEXT NOT NULL,
    FOREIGN KEY(file_id) REFERENCES files_catalog(id) ON DELETE CASCADE
);
 
-- 3. Создаем таблицу точечных доступов
CREATE TABLE IF NOT EXISTS files_shares (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    file_id INTEGER NOT NULL,
    shared_with_id INTEGER NOT NULL,
    FOREIGN KEY(file_id) REFERENCES files_catalog(id) ON DELETE CASCADE
);
 
-- 4. Создаем системные индексы для ультрабыстрого поиска (чтобы флешка не тормозила)
CREATE INDEX IF NOT EXISTS idx_files_user ON files_catalog(user_id);
CREATE INDEX IF NOT EXISTS idx_files_hash ON files_catalog(file_hash);
CREATE INDEX IF NOT EXISTS idx_tags_file ON files_tags(file_id);