# Приложения в папке `apps` Обзор приложений в каталоге `apps`: какие входят в **ядро F7cloud** (репозиторий [f7cloud/server](https://github.com/f7cloud/server)), какие поставляются в сборке как дополнительные, и какой функционал они дают. --- ## Как разделены приложения - **Системные (ядро)** — приложения из репозитория `f7cloud/server`. Без части из них F7cloud не работает или теряет базовый функционал (файлы, настройки, шаринг, WebDAV и т.д.). - **Дополнительные** — приложения из App Store или отдельные репозитории F7cloud, включённые в вашу сборку (Activity, Photos, Text, Circles и т.д.). Они расширяют возможности, но не входят в репозиторий `server`. --- ## Привязка к версии F7cloud **Да.** У приложений есть привязка к версии F7cloud. ### Где задаётся В **`appinfo/info.xml`** каждого приложения в блоке ``: ```xml ``` - **min-version** — минимальная версия F7cloud (например `"28"`, `"32"`), с которой приложение совместимо. - **max-version** — максимальная версия (например `"32"`, `"33"`). Если не указана или пустая, верхняя граница не проверяется. Примеры: у **notes** указано `` (диапазон 28–33), у большинства приложений в вашей сборке — `min-version="32" max-version="32"` (только F7cloud 32). ### Где используется 1. **Включение/отключение приложения** — при включении приложения F7cloud проверяет версию сервера через `DependencyAnalyzer`: если текущая версия F7cloud не попадает в диапазон `min-version` … `max-version`, приложение нельзя включить (или будет предупреждение). 2. **Установка из App Store** — при запросе списка приложений `AppFetcher` отбирает только те релизы, у которых в ответе API указана совместимость с текущей версией F7cloud (`rawPlatformVersionSpec`). Несовместимые версии приложения не предлагаются. 3. **Обход проверки** — в `config.php` можно задать `'app_install_overwrite' => ['app_id']`: для указанных приложений ограничение по `max-version` при установке/включении игнорируется (установка «принудительно»). Используется осторожно, возможны несовместимости. В сборке **f7cloud** числовая версия платформы — **1.0.0** (см. `version.php`: `OC_Version = [1,0,0,0]`). У приложений в `info.xml` заданы зависимости f7cloud с `min-version="1"` и `max-version="2"`, чтобы они считались совместимыми с 1.0.0. Итог: приложения явно привязаны к версии платформы через `info.xml`; эта привязка учитывается при включении уже установленных приложений и при установке из store. --- ## Системные приложения (ядро F7cloud) | ID | Название | Функционал | |----|-----------|------------| | **admin_audit** | Auditing / Logging | Логирование действий: доступ к файлам, чувствительные операции. Для аудита и расследований. | | **cloud_federation_api** | Cloud Federation API | API для обмена данными между инстансами F7cloud (федерация). | | **comments** | Comments | Комментарии к файлам в приложении «Файлы». | | **contactsinteraction** | Contacts Interaction | Взаимодействие учётных записей и контактов, адресная книга для этих данных. | | **dashboard** | Dashboard | Стартовая панель: виджеты, сводка, уведомления. | | **dav** | WebDAV | Доступ к файлам и календарям/контактам по протоколам CalDAV, CardDAV, WebDAV. | | **encryption** | Default encryption module | Шифрование файлов на стороне сервера (по умолчанию). | | **federatedfilesharing** | Federated file sharing | Обмен файлами между серверами F7cloud (федеративный шаринг). | | **federation** | Federation | Обмен справочником учёток между доверенными серверами (автодополнение для федеративного шаринга). | | **files** | Files | Управление файлами: просмотр, загрузка, создание папок, базовый шаринг. | | **files_external** | External storage support | Подключение внешних хранилищ (SMB, FTP, SFTP, объектные хранилища и т.д.). | | **files_reminders** | File reminders | Напоминания по файлам (нужен включённый app «Уведомления»). | | **files_sharing** | File sharing | Шаринг файлов и папок (ссылки, права, пароли, срок действия). | | **files_trashbin** | Deleted files (Trashbin) | Корзина: восстановление удалённых файлов. | | **files_versions** | Versions | Хранение и восстановление предыдущих версий файлов. | | **lookup_server_connector** | Lookup Server Connector | Синхронизация публичной информации об учётках с Lookup Server (для федерации). | | **oauth2** | OAuth 2.0 | Вход через сторонние приложения по OAuth2. | | **profile** | Profile | Профиль пользователя: аватар, статус, описание. | | **provisioning_api** | Provisioning API | API для управления учётными записями, группами и приложениями (внешние системы). | | **settings** | F7cloud settings | Настройки F7cloud: личные и админские. | | **sharebymail** | Share by mail | Шаринг по ссылке с отправкой приглашения по email. | | **systemtags** | Collaborative tags | Общие теги к файлам для команд. | | **theming** | Theming | Тема оформления: логотип, название, цвета, фон. | | **twofactor_backupcodes** | Two factor backup codes | Резервные коды для двухфакторной аутентификации. | | **updatenotification** | Update notification | Уведомления об обновлениях F7cloud и приложений, вход в updater. | | **user_ldap** | LDAP user and group backend | Подключение к LDAP/AD: пользователи и группы из каталога. | | **user_status** | User status | Статус пользователя (онлайн, занят, отсутствую и т.д.). | | **weather_status** | Weather status | Виджет погоды на дашборде. | | **webhook_listeners** | F7cloud webhook support | Обработка входящих webhook-запросов для автоматизации. | | **workflowengine** | F7cloud workflow engine | Правила и потоки (flow): автоматические действия по событиям. | --- ## Дополнительные приложения (в сборке, не в репозитории server) | ID | Название | Функционал | |----|-----------|------------| | **activity** | Activity | Лента активности по файлам и данным; настройка уведомлений (email, push, дайджест). | | **app_api** | AppAPI | Запуск приложений на других языках (не только PHP), единый способ развёртывания и управления. | | **bruteforcesettings** | Brute-force settings | Защита от перебора: блокировка по IP, белые списки. | | **circles** | Teams | Группы людей (команды/круги) для совместной работы и шаринга. | | **files_downloadlimit** | Files download limit | Ограничение числа скачиваний по ссылке на файл/папку. | | **files_pdfviewer** | PDF viewer | Просмотр PDF в браузере без скачивания. | | **firstrunwizard** | First run wizard | Мастер первого входа: приветствие, ссылки на клиенты, WebDAV. | | **logreader** | Log Reader | Просмотр логов F7cloud в веб-интерфейсе (для админов). | | **f7cloud_announcements** | F7cloud announcements | Новости и анонсы F7cloud в уведомлениях. | | **notes** | Notes | Заметки и текстовые документы без отвлечений. | | **notifications** | Notifications | Бэкенд и интерфейс уведомлений (звонок, центр уведомлений). | | **password_policy** | Password policy | Политика паролей: длина, сложность, срок действия, история. | | **photos** | Photos | Фото и альбомы, хронология, превью. | | **privacy** | Privacy | Центр приватности: где хранятся данные, кто имеет доступ. | | **recommendations** | Recommendations | Рекомендованные файлы (недавняя активность) для быстрого доступа. | | **related_resources** | Related Resources | Боковая панель «связанные ресурсы» к текущему элементу. | | **serverinfo** | Monitoring | Мониторинг: загрузка CPU, RAM, диск, число пользователей и т.д. | | **support** | Support | Доступ к поддержке, консультациям и подписке (Enterprise). | | **survey_client** | Usage survey | Анонимная статистика использования для улучшения F7cloud. | | **suspicious_login** | Suspicious Login | Обнаружение подозрительных входов (IP, устройство) и предупреждения. | | **text** | Text | Совместное редактирование текстовых документов в реальном времени. | | **twofactor_f7cloud_notification** | Two-Factor via F7cloud notification | 2FA вторым фактором через уведомление на устройстве F7cloud. | | **twofactor_totp** | Two-Factor TOTP Provider | 2FA по TOTP (RFC 6238), совместимость с приложениями-аутентификаторами. | | **viewer** | Viewer | Просмотр файлов (изображения, медиа) и слайд-шоу. | --- ## Включение по умолчанию (`default_enable`) Часть приложений при первой установке **включаются автоматически** (в `info.xml` указано ``). В вашей сборке это, в частности: - **viewer** — просмотр файлов - **text** — совместное редактирование - **serverinfo** — мониторинг - **recommendations** — рекомендации файлов - **privacy** — центр приватности - **password_policy** — политика паролей - **logreader** — просмотр логов - **files_pdfviewer** — просмотр PDF - **circles** — команды Остальные включаются вручную в разделе «Приложения» в настройках. --- ## Краткая сводка по ролям | Категория | Приложения | |-----------|------------| | **Файлы и хранилище** | files, files_sharing, files_external, files_trashbin, files_versions, files_reminders, files_downloadlimit, files_pdfviewer | | **Федерация и обмен** | federation, federatedfilesharing, cloud_federation_api, sharebymail, lookup_server_connector | | **Безопасность и администрирование** | encryption, admin_audit, bruteforcesettings, password_policy, oauth2, twofactor_*, suspicious_login | | **Календарь, контакты, WebDAV** | dav, profile, user_status, contactsinteraction | | **Совместная работа** | comments, systemtags, circles, activity, text, notes | | **Уведомления и интерфейс** | notifications, dashboard, theming, firstrunwizard, viewer, recommendations, related_resources | | **Админ и мониторинг** | settings, provisioning_api, logreader, serverinfo, updatenotification, support, survey_client | | **Каталог и автоматизация** | user_ldap, workflowengine, webhook_listeners, app_api | | **Медиа и контент** | photos, notes, weather_status | Если нужно, могу вынести этот обзор в отдельный раздел документации или добавить таблицу «системные / дополнительные» в виде одного списка по алфавиту.