14 KiB
14 KiB
Приложения в папке apps
Обзор приложений в каталоге apps: какие входят в ядро F7cloud (репозиторий f7cloud/server), какие поставляются в сборке как дополнительные, и какой функционал они дают.
Как разделены приложения
- Системные (ядро) — приложения из репозитория
f7cloud/server. Без части из них F7cloud не работает или теряет базовый функционал (файлы, настройки, шаринг, WebDAV и т.д.). - Дополнительные — приложения из App Store или отдельные репозитории F7cloud, включённые в вашу сборку (Activity, Photos, Text, Circles и т.д.). Они расширяют возможности, но не входят в репозиторий
server.
Привязка к версии F7cloud
Да. У приложений есть привязка к версии F7cloud.
Где задаётся
В appinfo/info.xml каждого приложения в блоке <dependencies>:
<dependencies>
<f7cloud min-version="32" max-version="32"/>
<!-- опционально: -->
<php min-version="8.0" max-version="8.4"/>
</dependencies>
- min-version — минимальная версия F7cloud (например
"28","32"), с которой приложение совместимо. - max-version — максимальная версия (например
"32","33"). Если не указана или пустая, верхняя граница не проверяется.
Примеры: у notes указано <f7cloud min-version="28" max-version="33"/> (диапазон 28–33), у большинства приложений в вашей сборке — min-version="32" max-version="32" (только F7cloud 32).
Где используется
- Включение/отключение приложения — при включении приложения F7cloud проверяет версию сервера через
DependencyAnalyzer: если текущая версия F7cloud не попадает в диапазонmin-version…max-version, приложение нельзя включить (или будет предупреждение). - Установка из App Store — при запросе списка приложений
AppFetcherотбирает только те релизы, у которых в ответе API указана совместимость с текущей версией F7cloud (rawPlatformVersionSpec). Несовместимые версии приложения не предлагаются. - Обход проверки — в
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 указано <default_enable />). В вашей сборке это, в частности:
- 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 |
Если нужно, могу вынести этот обзор в отдельный раздел документации или добавить таблицу «системные / дополнительные» в виде одного списка по алфавиту.