Каждая директория и файл внутри капсулы модуля modules/file_manager/ выполняют строго изолированную роль, подчиненную глобальному ядру Universal CMS [INDEX].

• init.php — Входной шлюз модуля (Регистратор)
  • За что отвечает: Первым принимает управление от роутера ядра (core/router.php) [INDEX].
  • Логика: Проверяет сессию пользователя. Если пользователь гость — блокирует доступ. Если авторизован — динамически регистрирует модуль в главном меню шаблонизатора ({menu}) [INDEX].
• controller.php — Главный мозг модуля (Диспетчер команд)
  • За что отвечает: Обрабатывает любые POST/GET запросы, прилетающие от JavaScript из браузера [INDEX].
  • Логика: Содержит функции actionUpload(), actionDelete(), actionRename(), actionChangeAccess(). Он не решает, можно ли юзеру смотреть файл, он лишь выполняет физические действия (перенос, удаление, вызов FFmpeg) и делает записи в БД [INDEX].
• core_api.php — Внутреннее окно связи (Шлюз безопасности)
  • За что отвечает: Единственная точка входа для других модулей (например, для модуля Книжной библиотеки library) [INDEX].
  • Логика: Когда библиотека просит файл проекта, этот файл проверяет права текущего юзера. Он лезет в БД file_manager.db в таблицу files_catalog, смотрит поле access_level [INDEX]. Если там стоит private и ID юзера не совпадает с владельцем — шлюз рубит запрос до того, как файл скачается, выдавая ошибку 403 [INDEX].

• admin_panel.php — Локальный пульт управления модулем
  • За что отвечает: Настройки модуля, доступные исключительно для роли superuser (Главный Root) [INDEX].
  • Логика: Генерирует форму в глобальном Дашборде ядра, где Суперадмин может:
    • Задать разрешенные расширения файлов (запретить .exe, .sh) [INDEX].
    • Изменить цвет вкладок (theme_tab_color) и фон интерфейса менеджера [INDEX].
    • Напрямую читать файл действий file_actions.log [INDEX].
  • Связь с БД/Конфигом: Записывает настройки в локальный modules/file_manager/config.ini [INDEX].

• view.html — Каркас интерфейса (Таблица и 4 вкладки со скриншота)
  • За что отвечает: Чистая разметка HTML5. Содержит сетку (Grid) для вывода папок проектов Игоря (как папки «test», «мурманск») и зону Drag-and-Drop для перетаскивания файлов мышкой [INDEX]. Внизу содержит разметку 4-х вкладок («README», «Лицензия», «Комментарий», «Лог действий») [INDEX]. Не содержит PHP-кода!
• assets/css/manager.css — Локальный стиль оформления
  • За что отвечает: Стилизация интерфейса менеджера. Важный момент: цвета вкладок и фона здесь прописаны через CSS-переменные (–tab-color), которые динамически подставляются из локального config.ini [INDEX].
• assets/js/manager.js — Двигатель интерфейса (JavaScript)
  • За что отвечает: Перехватывает сброс файлов мышкой (переводит Drag-and-Drop в поток данных), отправляет асинхронные запросы fetch() к controller.php [INDEX]. Отвечает за плавное переключение нижних вкладок без перезагрузки страницы (запрашивает тексты из папки logs/) [INDEX].

• config.ini — Локальный файл конфигурации модуля
  • За что отвечает: Хранит лимиты и настройки внешнего вида, заданные Суперадмином через admin_panel.php [INDEX]. Полностью изолирован от ядра [INDEX].
• file_manager.db — База данных SQLite (Сердце учета)
  • За что отвечает: Хранит всю информацию о правах, приватности, хэшах и виртуальных папках [INDEX].
  • Связь с кодом: Именно поля этой БД (access_level, virtual_folder, is_deleted) определяют поведение controller.php и core_api.php [INDEX]. Физический файл на диске переименован в безопасный ID, а его реальное русское имя помнит только эта БД [INDEX].
• lang/ — Папка децентрализованных переводов
  • ru.php — Хранит перевод кнопок и вкладок интерфейса на русский язык.
  • fr.php — Позволяет расширить менеджер французским или любым другим языком без ковыряния в ядре [INDEX].
• logs/ — Контент вкладок и история (Текстовая база)
  • file_actions.log — Сюда контроллер пишет каждую загрузку/удаление в формате дата|юзер|действие|результат [INDEX].
  • readme.txt — Текстовый файл. Его содержимое модуль core_edit выводит и позволяет редактировать во вкладке «README» [INDEX].
  • license.txt — Юридические условия папки проекта (Вкладка «Лицензия») [INDEX].
  • comments.txt — Личные заметки пользователя о проекте (Вкладка «Комментарий») [INDEX].

• storage/ — Директория изолированных пространств
  • За что отвечает: Сюда физически падают файлы [INDEX]. Доступ из браузера напрямую по ссылкам сюда закрыт через .htaccess ядра [INDEX].
  • igor/, alisa/, root_admin/ — Персональные папки пользователей, которые создаются автоматически при их первой загрузке файла [INDEX]. Зайти в папку alisa/ скрипт позволит только в том случае, если в сессии ядра $_SESSION['username'] === 'alisa', либо если файл имеет статус public в БД file_manager.db [INDEX].