# Nextcloud User Manual — выжимка для работы (по PDF)

Источник: `docs/Nextcloud_User_Manual.pdf` (Release latest, Feb 26, 2026).

## Что важно для повседневной работы

### 1) Веб-интерфейс

- Поддерживаемые браузеры: Chrome/Chromium, Firefox, Safari, Edge.
- Internet Explorer не поддерживается.
- Ключевые зоны интерфейса: меню приложений, поиск, контакты, меню профиля/настроек, список файлов.

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

### 2) Файлы и синхронизация

Блок 3.x — основной:

- Файлы в web UI: загрузка, папки, фильтры, перемещение, предпросмотр, комментарии, теги.
- WebDAV: доступ к файлам сторонними клиентами (Linux/macOS/Windows/cURL/WinSCP/Cyberduck).
- Deleted files: восстановление/очистка, влияние квот.
- Версии: история версий, переименование/удаление версий.
- Шаринг: публичные ссылки, внутренние шары, федеративные шары.
- Anonymous uploads (file drop).
- Большие файлы, квоты, transfer ownership.

Практика:
- Для автоматизации использовать `files list/search/get/upload/delete`.
- Для межсистемного доступа — WebDAV + app password.
- При проблемах «нет места» проверять квоты + deleted files + versions.

### 3) Контакты и календари

Блок 4.x:

- Contacts app
- Calendar app
- Синхронизация с Android/iOS/macOS/Thunderbird/KDE/GNOME/Windows

Практика:
- В автоматизации контакты вести через CardDAV-команды (`contacts ...`, `addressbooks list`).
- События — через CalDAV-команды (`calendar ...`, `calendars list`).
- Для стабильности всегда использовать явный календарь/адресную книгу.

### 4) Безопасность

Блок 9.x и 10.x:

- 2FA
- Recovery codes
- Device-specific passwords
- Управление подключёнными браузерами/устройствами

Практика:
- Для CLI интеграции использовать app password (device-specific), не основной пароль.
- При ошибках авторизации первым делом проверять токен/срок действия app password.

### 5) Desktop Client

Блок 6.x:

- Установка
- Синхронизация
- Конфликты
- Обновления

Практика:
- Если файлы «пропали» только локально — сначала проверять статус sync-клиента и конфликтные копии.

---

## Карта соответствия PDF ↔ рабочие команды skill

- Файлы (Manual 3.1–3.4, 3.10–3.12) → `files *`
- Шаринг/федерация (Manual 3.7, 3.8, 3.15) → частично через web UI/серверные API (в текущем CLI прямых команд шаринга нет)
- Контакты (Manual 4.1) → `contacts *`, `addressbooks list`
- Календарь (Manual 4.2) → `calendar *`, `calendars list`
- Задачи (CalDAV VTODO, смежно с календарным стеком) → `tasks *`
- WebDAV доступ (Manual 3.2) → используется CLI внутри `files *`

---

## Что не покрыто текущим skill напрямую

- Nextcloud Talk (глава 5)
- UI-темы/Accessibility (глава 8)
- Полное управление шэрингом на уровне тонких прав (link expiry/password и т.п.)
- 2FA-администрирование через отдельные команды

Для этих сценариев: либо web UI, либо отдельный специализированный инструмент/API.