Документы
Храните и управляйте документами объектов с настройкой видимости по ролям
Что такое документы объекта?
Управление файлами
Что можно хранить?
- Официальные документы (договоры, соглашения, сертификаты)
- Техническая документация (чертежи, инструкции, спецификации)
- Информационные материалы (заметки, записки, отчёты)
- Схемы и планы (планы этажей, схемы проводки)
- Файлы паролей (коды доступа, пароли WiFi)
Права доступа
Только владельцы и их представители могут управлять документами. Другие участники могут просматривать документы только если им предоставлена видимость.
| Роль | Просмотр документов | Добавление документов | Редактирование видимости | Удаление документов |
|---|---|---|---|---|
| Наймодатель | Да | Да | Да | Да |
| Представитель наймодателя | Да | Да | Да | Да |
| Наниматель | Если видимый | Нет | Нет | Нет |
| Представитель нанимателя | Если видимый | Нет | Нет | Нет |
| Обслуживающий персонал | Если видимый | Нет | Нет | Нет |
Как добавить документ?
Перейдите к своему объекту
Откройте страницу объекта, куда хотите добавить документ.
Откройте раздел Документы
Нажмите "Документы" в меню объекта, чтобы перейти на страницу документов.
Нажмите Добавить документ
Выберите тип документа, загрузите файл и укажите, кто видит этот документ.
Сохраните
Нажмите сохранить для загрузки документа. Он будет безопасно сохранён в облаке.
Видимость документа
При добавлении или редактировании документа вы можете выбрать, какие роли его видят. Владелец и представитель владельца всегда видят все документы.
Выберите чтобы показать документ нанимателям
Выберите чтобы показать документ представителям нанимательов
Выберите чтобы показать документ тех. работникам
Совет: Видимый для всех
Если вы не выберете ни одной конкретной роли, документ будет видим всем участникам объекта.
Комментарий
Опциональный текстовый комментарий к документу (до 1000 символов)
Комментарий
- Комментарий является необязательным полем
- Максимальная длина комментария - 1000 символов
- Комментарий отображается в списке документов
Как изменить видимость документа?
Найдите документ
Перейдите в раздел Документы вашего объекта и найдите документ, который хотите редактировать.
Нажмите кнопку Редактировать
Нажмите кнопку редактирования (иконка карандаша) рядом с документом, чтобы открыть настройки видимости.
Обновите видимость и сохраните
Выберите или снимите выбор ролей, которые должны видеть этот документ, затем нажмите Сохранить.
Типы документов
Каждый тип документа имеет свои разрешённые форматы файлов и ограничения размера.
| Тип | Допустимые форматы | Макс. размер |
|---|---|---|
| Официальный документ | .pdf .doc .docx .odt .rtf | 20 MB |
| Технический документ | .pdf .doc .docx .dwg .dxf .xls .xlsx | 50 MB |
| Информационный документ | .pdf .doc .docx .txt .md | 10 MB |
| Схема / План | .jpg .jpeg .png .gif .svg .webp .pdf | 20 MB |
| Файл паролей | .txt .pdf .doc .docx | 1 MB |
Фильтрация и поиск
Страница документов предоставляет несколько способов найти нужные документы.
Фильтр по типу
Показать только определённые типы документов
Фильтр по дате
Найти документы за определённый период
Пагинация
20 документов на страницу для удобной навигации
API документов
Управляйте документами программно через наш REST API. Все операции API автоматически синхронизируются с Google Drive и отправляют уведомления.
Примечание уровня сервиса
GET /api/v1/properties/{id}/documents # Список документов
POST /api/v1/properties/{id}/documents # Загрузить документ
GET /api/v1/documents/{id} # Получить детали документа
PUT /api/v1/documents/{id} # Обновить видимость
DELETE /api/v1/documents/{id} # Удалить документ
Изучите полную документацию API в Swagger UI
Открыть документацию APIИнтеграция с Google Drive
Все загруженные документы автоматически синхронизируются с Google Drive. Это обеспечивает дополнительное резервное копирование и удобный доступ с любого устройства.
Как это работает
- Документы автоматически загружаются в Google Drive после сохранения в системе
- Каждый объект имеет свою папку в Drive, организованную по типу документа
- Рядом с каждым синхронизированным документом появляется иконка Google Drive — нажмите, чтобы открыть в Drive
- При удалении документа из системы он также удаляется из Google Drive
- Уведомления по email и Telegram содержат ссылки на файл и папку в Google Drive
Доступ к Google Drive
Участники объекта автоматически получают доступ к соответствующей папке Google Drive. Доступ управляется через систему — не предоставляйте общий доступ к папкам Drive вручную.
Уведомления
Система автоматически отправляет уведомления при загрузке или удалении документов. Уведомления получают все участники объекта, кроме того, кто выполнил действие.
| Событие | Telegram | Ссылки Drive | |
|---|---|---|---|
| Документ загружен | Ссылка на файл + папку | ||
| Документ удалён | Ссылка на папку (файл удалён) | ||
| Документ прикреплён к имуществу | Ссылка на файл + папку | ||
| Документ откреплён от имущества | Ссылка на папку |
Вы можете включить или отключить уведомления для каждого канала (Email, Telegram) в настройках аккаунта.
API документов
Управляйте документами программно через наш REST API. Все операции API автоматически синхронизируются с Google Drive и отправляют уведомления.
| Операция | Метод | Синхронизация Drive | Уведомления |
|---|---|---|---|
| Загрузить документ | POST |
Автоматически | Автоматически |
| Удалить документ | DELETE |
Автоматически | Автоматически |
| Отвязать от сущности | DELETE |
— | — |
Полная документация API с примерами доступна по адресу /api/v1/doc