Настройки модуля «Управление документами»

Раздел пользовательской админки «Управление документами» (/settings/files/) объединяет настройку прав доступа к категориям файлов и параметры модуля FileSettings.

Доступ:

1. Перейдите в "Настройки" -> "Управление документами"
2. Требуется право system.settings (группа System-Settings или аналог)
3. Дополнительно в системной админке Django: "Files" -> "File settings" / "File categories"

На странице две вкладки: «Категории и права» и «Настройки».

1. Вкладка «Категории и права»

Интерфейс аналогичен справочникам категорий заявок сервис-деска: иерархическая таблица категорий с отступами по уровню вложенности, кнопки создания/изменения/удаления.

В таблице отображаются:

• наименование категории (с учётом иерархии);
• синонимы (для автоподсказок при загрузке);
• назначенные права доступа (подразделения и сотрудники с уровнем прав);
• действия редактирования и удаления.

Создание и изменение категории

По кнопке «Добавить» или иконке редактирования открывается всплывающее окно формы.

Поля категории:

• Наименование — название категории файлов;
• Родительская категория — для построения иерархии (глубина ограничена настройкой FILES_TREE_LEVELS);
• Синонимы — слова через запятую для сопоставления при анализе содержимого загружаемых файлов.

Уровни доступа

Для каждой категории можно назначить права подразделениям и/или отдельным сотрудникам. Уровни:

Один субъект не должен дублироваться на разных уровнях одной категории: при сохранении оставляется максимальный из выбранных уровней.

Права подразделений

• Можно выбрать одно или несколько подразделений для каждого уровня.
• Права выбранного подразделения распространяются на все вложенные подразделения без ограничения глубины (если выдано родителю — доступ есть и у сотрудников дочерних подразделений).

Права сотрудников

• Можно назначить доступ конкретным сотрудникам независимо от подразделения.
• Уровни те же: чтение / чтение и добавление / полный доступ.

Наследование прав по дереву категорий

• Если у подкатегории нет собственных правил, к ней применяются права ближайшего предка, у которого правила заданы.
• Если у подкатегории есть свои правила, учитываются только они; права родителя не подмешиваются.
• Цепочка наследования прерывается на первом предке (или на самой категории) с собственными правилами.

Пример: доступ выдан на корневую категорию «Договоры». Подкатегория «Акты» без своих правил наследует этот доступ. Если у «Акты» назначены отдельные правила — наследуются уже они, а не «Договоры».

Когда категория считается «открытой»

Если ни у категории, ни у её предков нет ни одного правила доступа, ограничения по категории не применяются (загрузка и видимость определяются другими правилами модуля — см. ниже).

2. Вкладка «Настройки»

Редактирование выполняется так же, как в системных настройках (например, раздел «Безопасность»): нажмите карандаш у строки, измените значение, сохраните. Изменения применяются сразу через HTMX без перезагрузки страницы.

ALLOWED_FILE_EXTENSIONS (String)

• Название: Разрешенные расширения файлов для загрузки в систему файлов
• Описание: Список расширений через запятую, разрешённых для загрузки в каталог документов
• Значение по умолчанию: .doc,.docx,.xls,.xlsx,.ppt,.pptx,.pdf,.txt,.rtf,.odt,.ods,.odp,.csv,.jpg,.jpeg,.png,.gif,.bmp,.tiff,.html,.htm,.msg,.eml,.zip,.rar,.7z

FILES_TREE_LEVELS (Int)

• Название: Количество уровней вложенности файлов (подпапок), исключая корневую
• Описание: Максимальная глубина иерархии категорий файлов (без учёта корневого уровня)
• Значение по умолчанию: 3

FILES_EXPAND_SUBCATEGORIES (Bullet)

• Название: Разворачивать подкатегории документов в меню
• Описание: Если включено, подкатегории в меню файлового менеджера отображаются развёрнутыми
• Значение по умолчанию: False

FILES_SHOW_EMPTY_CATEGORIES (Bullet)

• Название: Отображать категории без документов
• Описание: Если включено, пустые категории видны в меню. Если выключено — скрываются; родительские категории с файлами в подкатегориях по-прежнему отображаются
• Значение по умолчанию: False

3. Как работает доступ в файловом менеджере

Помимо прав категорий, действуют групповые и контекстные правила.

Группы

• Files-View — просмотр всех записей каталога документов
• Files-Manage — полный доступ ко всем записям (просмотр, добавление, изменение, удаление)
• Top-Man / суперпользователь — полный доступ

Назначение групп: Управление пользователями.

Без глобальных групп Files-*

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

1. Видны файлы своего подразделения (department файла = подразделение сотрудника).
2. Видны файлы категорий, к которым есть доступ по правилам (сотрудник / подразделение с учётом каскада подразделений и наследования категорий).
3. Видны документы доступных проектов (отдельная логика модуля проектов).

Права django-rules:

• files.view — просмотр;
• files.add — добавление (уровень «чтение и добавление» или выше);
• files.edit / files.change_file — полный доступ, включая удаление.

Если у категории (с учётом наследования) заданы правила, загрузка в неё разрешена только при уровне не ниже «чтение и добавление» (или при членстве в Files-Manage / Top-Man / суперпользователь).

4. Справочники модуля

• Категории файлов — иерархическая структура (MPTT), настраивается на вкладке «Категории и права» или в Django admin (Files -> File categories).