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

## Структура и отображение

Файлы и папки отображаются в табличном виде. В каждой строке присутствует:

- для папок:
  - название объекта
  - иконка удаления `корзина`
  - иконка контекстного меню `...` для действий: *переименовать, переместить, копировать*. 

- для файлов:
  - название объекта
  - дата последнего изменения
  - размер 
  - автор 
  - иконки действий (*скачать файл, детали, удалить*)
  - иконка контекстного меню `...` для действий: *переименовать, переместить, копировать*.

![image](https://storage.yandexcloud.net/zakroma-ru/media/a50cfae546278d4ce0591a6ec9dde477.png)

## Создание папок

>Функция доступна пользователям с ролями *Редактор, Владелец* или *Администратор* в рамках проекта, в котором создаётся папка.

Для создания папки нажмите кнопку **Создать папку**, расположенную на верхней панели проекта.  В открывшемся окне введите название и нажмите **Создать**.

После этого папка отобразится в текущем каталоге.

![image](https://storage.yandexcloud.net/zakroma-ru/media/3452bf799e195f7d40a29fd63d2ee0a1.png)
## Загрузка файлов

Для добавления файлов используйте кнопку **Загрузить файл**, либо перетащите файл в область содержимого (поддерживается drag & drop). После загрузки файл отображается в списке.

Поддерживается загрузка любых форматов файлов.
## Предпросмотр

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

Файл откроется в модальном окне, откуда его можно скачать или просмотреть дополнительную информацию о файле.

![image](https://storage.yandexcloud.net/zakroma-ru/media/bc50715268eae33caac96772b676760f.png)

Ниже представлены поддерживаемые для предпросмотра типы файлов:
#### Документы:

`docx, doc, pdf, txt, rtf, odt, pptx, xlsx, xls, csv`
#### PDF и текстовые файлы:

`pdf, txt, json`
#### Таблицы:

`xlsx, ods, csv, xls, xlw, xlt, xml, pxl, wb2, wq1`
#### Изображения:

`jpg, jpeg, png, gif, webp, bmp, svg`
#### Видео:

`mp4, webm`
#### Аудио:

`mp3, wav, ogg`

## Детали

При нажатии на иконку `i` **Детали** пользователь видит всплывающее окно с тремя вкладками: **«Информация»**, **«Поделиться»**, **«Версии»**.

![image](https://storage.yandexcloud.net/zakroma-ru/media/0cf690bd43ffe37076292d8dcebe94ac.png)

### Информация

Вкладка **«Информация»**  позволяет быстро получить техническую информацию о файле и его расположении в системе. Вкладка содержит основные сведения о выбранном файле:

- **Название файла**  
  Отображается имя файла, например: `2025.png`.
- **Размер**  
  Указывается вес текущей версии файла, например: `1.62 MB`.
- **Дата загрузки**  
  Показывается точное время и дата добавления файла в систему, например: `28.03.2025, 12:43`.
- **Автор**  
  Имя пользователя, загрузившего файл.
- **MIME-тип**  
  Тип содержимого файла, например: `image/png`.
- **Полный путь**  
  Указывается путь до файла в структуре папок, например:  
  `/tech-writter/Первая папка/folder 2/2025.png`.
- **Теги**  
  Пользовательские метки, которые можно добавлять для быстрой фильтрации и поиска.
### История версий

Если проект привязан к бакету с включённым режимом **версионирования**, система автоматически сохраняет все загруженные версии файла.

Как открыть историю:

1. Откройте папку, содержащую необходимый файл, нажмите иконку `i` **Детали**
2. В открывшемся окне выберите вкладку **Версии**;
3. В открывшемся окне отобразятся все сохранённые версии: дата, размер, автор;
4. Доступны действия:
   - скачать версию;
   - скопировать внутреннюю ссылку;
   - скопировать файл в другую папку;
   - удалить версию.

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

## Поделиться 

Для любого загруженного файла можно **сгенерировать ссылку**, по которой файл будет доступен на скачивание другим пользователям. 

Во вкладке **«Поделиться»** доступны следующие опции:

- **Создать публичную ссылку**  
  Система сгенерирует URL, по которому любой человек сможет просмотреть или скачать файл, не заходя в систему. Ссылка автоматически копируется в буфер обмена при нажатии на иконку копирования. Это удобно, если необходимо быстро поделиться документом с внешними коллегами.

- **Скопировать внутреннюю ссылку**  
  Используется для обмена файлами внутри проекта. Такая ссылка работает только у авторизованных пользователей, имеющих доступ к текущему проекту или папке. Это обеспечивает дополнительную защиту и контроль доступа к корпоративным данным.

> При необходимости публичную ссылку можно деактивировать - после этого доступ по ней будет закрыт.

### Как сгенерировать ссылку:

![image](https://storage.yandexcloud.net/zakroma-ru/media/ce3289a028c9f83dd3611d7c4e272269.png)

1. Откройте папку, содержащую необходимый файл, нажмите иконку `i` **Детали**
2. В открывшемся окне выберите вкладку **Поделиться**;
3. В открывшемся окне установите, при необходимости, дату и время окончания действия ссылки - не более 168 часов (8 дней);
4. Нажмите **OK** для завершения генерации.

При выборе варианта **внутренняя ссылка** система покажет ссылку, которую можно скопировать. 
При выборе варианта **публичная ссылка** система отображает окно с:

- сгенерированной короткой ссылкой;
- QR-кодом, ведущим по этой ссылке;
- кнопками для копирования ссылки или QR-кода.

![image](https://storage.yandexcloud.net/zakroma-ru/media/a17b1c68cce28eb99a05195c6e317a2d.png)

Пользователь, получивший эту ссылку, сможет скачать файл на своё устройство без авторизации.

> [!info] Временная ссылка
> Публичная ссылка ограничена по времени действия. По истечении срока она становится недействительной.


Работа с файлами, папками и версиями в интерфейсе Закрома.Диск

Файлы и папки

Работа с Диском

Хранение данных в **Закрома.Диск** осуществляется в **Проектах**. В каждом проекте пользователь работает с папками и файлами, которые расположены в виде дерева. 
Внутри проекта пользователь может разграничивать доступ, создавать папки, загружать и просматривать файлы и их историю.

## Создание проекта

Создание проекта доступно из главного интерфейса. Для этого предусмотрена кнопка **Создать проект**, расположенная под списком существующих проектов.

![image](https://storage.yandexcloud.net/zakroma-ru/media/2c3cc3e4561424ff59093cf94881e65d.png)

1. Нажмите **Создать проект**.
2. В открывшейся форме укажите:
   - Название проекта (обязательное поле);
   - Бакет, с которым будет связан проект (выбирается из выпадающего списка);
   - Включить или не включать версионирование (если такая опция отображается);
   - Имя бакета S3 (если необходимо создать новый).
3. Нажмите **Сохранить**.

![image](https://storage.yandexcloud.net/zakroma-ru/media/5e722f64a55381aa5b7ff090e5aabd05.png)

После сохранения проект отобразится в общем списке.

## Изменение и удаление проекта

Каждое название проект сопровождается иконкой контекстного меню `...`.

Через это меню доступны следующие действия:

- **Изменить** — открывает форму, в которой можно изменить название проекта, а также добавлять, удалять или изменять теги. 

![image](https://storage.yandexcloud.net/zakroma-ru/media/cde67acb5cf9c8f4311f43613872be7e.png)

![image](https://storage.yandexcloud.net/zakroma-ru/media/83a24755aced089022e6c2a4c800c36d.png)

- **Удалить** — удаляет проект. Действие необратимо и требует подтверждения.  

## Информация о бакете

При наведении курсора на проект отображается всплывающая подсказка с именем бакета, к которому он привязан:

Бакет определяет уровень хранения данных, наличие версионирования, а также технические параметры.  
Выбор бакета осуществляется при создании проекта и отображается в интерфейсе.

> [!warning] После создания проекта изменить связанный с ним бакет невозможно.

> [!info] Управление бакетом S3
> О том как управлять бакетом, Вы можете почитать в документации по [Закрома.Хранение](https://zakroma.ru/knowledgeBase/storage/article/buckets)


## Доступ к проекту

Доступ к проекту управляется через то же контекстное меню — пункт **Настройки доступа**.  
Пользователь с достаточными правами может:

- просматривать список участников проекта;
- назначать роли;
- добавлять пользователей и группы.

Подробности — см. раздел [Авторизация и доступ](https://zakroma.ru/knowledgeBase/disk/article/access?version=1.0).

>Пользователь видит только те проекты, к которым у него есть доступ. Доступные действия и отображение структуры проекта зависят от роли пользователя.

Создание, редактирование и удаление проектов в системе

Проекты


Данный раздел описывает процесс входа в систему **Закрома.Диск**, типы ролей, их права, а также базовые операции по управлению пользователями и группами доступа.
## Сценарий входа

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

- поле для ввода логина;
- поле для ввода пароля;
- кнопку **Войти**.

![image](https://storage.yandexcloud.net/zakroma-ru/media/f9ff051cc0f5a293ec1fbe463dfccb9b.png)

> Аутентификация реализована с помощью сервиса Keycloak.
## Типы ролей и права доступа

В системе предусмотрены четыре основных типа ролей пользователей, каждая из которых определяет доступ к операциям в рамках проекта:

<table style="width: 100%; border-collapse: collapse;">
  <thead>
    <tr>
      <th style="width: 20%; text-align: left; padding: 6px;">Роль</th>
      <th style="width: 80%; text-align: left; padding: 6px;">Доступные действия</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td style="padding: 6px;"><b>Читатель</b></td>
      <td style="padding: 6px;">Просмотр файлов и структуры проекта. Без возможности изменения.</td>
    </tr>
    <tr>
      <td style="padding: 6px;"><b>Редактор</b></td>
      <td style="padding: 6px;">Чтение, переименование, удаление файлов и папок.</td>
    </tr>
    <tr>
      <td style="padding: 6px;"><b>Владелец</b></td>
      <td style="padding: 6px;">Все права редактора, а также управление доступом и настройками проекта.</td>
    </tr>
    <tr>
      <td style="padding: 6px;"><b>Администратор</b></td>
      <td style="padding: 6px;">Полный доступ ко всем проектам. Может управлять пользователями и ролями.</td>
    </tr>
  </tbody>
</table>


> [!warning] Права доступа устанавливаются на уровне проекта. Установка прав доступа к отдельным папкам или файлам **не поддерживается**.

Настройка прав доступа осуществляется при создании проекта или через его контекстное меню. Владелец проекта может открыть управление доступом, выбрать пользователей или группы и назначить им соответствующие роли.
## Управление пользователями и группами

Управление доступом выполняется через интерфейс **Закрома.Диск**, в связке с системой Keycloak.

Чтобы назначить роли пользователям (на уровне проекта):

1. Наведите курсор на проект в списке.
2. Нажмите на иконку контекстного меню `...`.
3. Выберите **Настройки доступа**.
4. Добавьте пользователя или группу.
5. Назначьте одну из ролей: *Читатель*, *Редактор*, *Владелец*. 
6. При смене пользовательской роли также доступен вариант **Закрыть доступ**.

![image](https://storage.yandexcloud.net/zakroma-ru/media/db8e23ea1aa6daba0ce4dc467ca12af9.png)

>Только пользователи с ролью *Владелец или Администратор системы* могут управлять доступом других участников.





Как войти в систему и управлять правами пользователей

Авторизация и доступ

Обзор системы Закрома.Диск и её ключевых возможностей

Общее описание

Первые шаги пользователя в системе Закрома.Диск

С чего начать

Как подключить хранилище как сетевой диск в Windows

Подключение WebDAV

Ответы на популярные вопросы по работе с системой